Register a campaign
To crack down on spam and other undesirable messaging, carriers must know the legal entity responsible for each text message sent from software to a device on their network. Each phone number that will be sending messages from an application to a person must be associated with a “campaign” that explains who will be sending messages, why, and how the end user will opt in to and out of receiving them.
This guide covers registering a campaign through the API for an account.
Create an account
Skip this step if you already have an account for this campaign.
Many fields on the account are optional at this step but will be required to register a campaign. Certain fields will also affect requirements for other fields; organization.type
, for example, drastically affects which fields are required. We therefore recommend including all the fields you believe you need in the intial create to reduce iterations on providing missing fields.
See “Create an account”.
Here’s an example where most of the fields required for local messaging are provided.
Check account capabilities (optional)
This step allows you to check for missing or invalid fields on the account that must be provided or fixed before it is ready to register a campaign.
See “Check account status”.
This example checks the local messaging capability of the account created in the previous example.
Update account (optional)
If the capability request did not return a ready status, you’ll need to update the account to fix missing or broken fields. As mentioned in the “Create an account” step, fixing fields can uncover additional fields that need changed, so you may need to repeat this step and the previous until the account is ready for local messaging.
See “Update an account”.
This example provides the missing fields from the example in the previous step.
Create a campaign
Once the account is ready for local messaging you can create a campaign documenting its intended messaging use case.
See “Create a campaign”.
Purchase a phone number
While you await campaign approval, you can purchase a phone number for the account, and it will be ready to send text messages when the campaign is approved.
See “Create a phone number”.