10DLC
Campaigns

Campaigns

To send messages in the US, certain mobile network operators require that you submit a campaign. A campaign contains information about the messages you intend to send, which is then propagated to The Campaign Registry (opens in a new tab) (TCR).

Create and submit campaigns using either of the following ways:

Submit your campaign

To submit your campaign:

  1. Create a campaign using the Number Registration API (opens in a new tab). Each campaign must contain the following information:

    Information TypeDetails
    Basic information about the campaignName
    Connected Brand
    Campaign Summary
    Supported Message Types: SMS/MMS
    Use cases
    Terms & Conditions URL
    Low volume - true/false
    Direct lending - true/false
    Embedded link - true/false
    Embedded phone - true/false
    Age-gating - true/false
    Opt-In MethodsWEB
    KEYWORD
    VERBAL
    IVR
    Message ExamplesOpt-in Message Example
    Campaign Message Example
    Help Message Example
    Opt-out Message Example
    Customer care informationPhone number
    Email
    Numbers connected to the campaign (to be used as senders within the campaign)up to 49 numbers

    Make sure that you provide the correct information and that your campaign is compliant with local guidelines, as it will undergo a campaign review process.

  2. Register the campaign and trigger a campaign review.

    A campaign review by the Infobip Compliance Team can take up to 5 working days.

    This will trigger the campaign registration within TCR's CSP portal, and will start the campaign review process, as follows:

    • Once the campaign is fully approved, it is also registered with T-mobile, and you can then send traffic.

    • If your campaign is rejected, it is then deregistered, and you will be notified via email. You need to submit a new campaign and can use the same number.

    • You are charged for TCR campaign and brand fees, regardless of the review outcome. If you've registered your campaign directly with TCR, you are charged by TCR.

    • You are charged a monthly fee for your campaign.  For more information about pricing, see North America Pass-Through Fees (opens in a new tab).

  3. Check the campaign network status. The campaign network status indicates the registration status for each of the networks. Once your campaign is Active with all the networks, you can launch your campaign. To keep track of the campaign status, you can subscribe to the following webhooks for obtaining information about campaign status updates. These webhooks allow you to receive periodic updates when a change occurs.

    Webhook nameDescription
    CAMPAIGN_STATUS_UPDATEReceive campaign status update. For more information, see Campaign status change notification (opens in a new tab).
    CAMPAIGN_NETWORK_STATUS_UPDATEReceive campaign network status update. For more information, see Campaign network status notification (opens in a new tab).

    To receive the campaign status webhooks, create a subscription over Subscription Management, and use REGISTRATION as the channel. For more information, see Create subscription (opens in a new tab).

Campaign status

For campaign status from the US Sender Registration App, see Campaign status.

The following table shows campaign status over API.

Campaign API status

Description

DRAFTCampaign is still being drafted and not ready for review.
SUBMITTED_FOR_REVIEWFrom a business perspective, the campaign brief is ready to start the Infobip review process. The Infobip Compliance team review the campaign and provides feedback.
IN_REVIEWCampaign is being reviewed by Infobip Compliance team.
APPROVED_BY_INTERNAL_REVIEWERThe Infobip Compliance team finishes the review of the campaign and confirms that it is fully compliant with CTIA guidelines and operator-specific requirements.
SUBMITTEDCampaign has been submitted for carrier's review and approval. At this stage, the campaign network status may vary from carrier to carrier. For more details on carrier network status, see Campaign Network Status.
REGISTEREDYour campaign has been approved by all the carriers and can be launched.
DEREGISTEREDYour campaign has been deregistered with all the carriers.
REJECTEDYour campaign is not compliant with CTIA guidelines and operator-specific requirements and has been rejected by the Infobip Compliance team. 

Special cases

Number pooling

Up to 49 numbers can be connected to a single regular campaign. If you need more than 49 numbers connected to the campaign, your campaign needs to be registered with the Number Pooling attribute. This requires a special registration process and additional fees. For more information on such campaigns, contact your account manager or Infobip support.

External campaigns

If you are registered as a Campaign Service Provider (CSP) with TCR, you have the option to register your brand and campaign directly with TCR, but still send your traffic using Infobip.

In this case, when you create the campaign on TCR's CSP portal, you need to select "OpenMarket" as the connectivity partner for your campaign. Once your campaign has been created on TCR, you will need to import it to Infobip.

You then create (opens in a new tab) a campaign with the type set to EXTERNAL_TEN_DIGIT_LONG_CODE with the numbers linked to the campaign. Once it has been created on Infobip, you need to trigger the Register Campaign API request (opens in a new tab) to ensure full registration.

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Service Terms & ConditionsPrivacy policyTerms of use