Skip to main content

Create a Campaign

POST 
/registry/beta/brands/:id/campaigns

A Campaign belongs to a Brand.

To create a new managed campaign, send a POST request to the Campaign resource with all of the parameters except for csp_campaign_reference.

To create a new self-registered campaign, send a POST request to the same Campaign resource except that you only need to fill out the name and csp_campaign_reference parameters.

Please note: the csp_self_registered parameter has been deprecated and is no longer required.

Permissions​

The API token must include the following scopes: Messaging.

Request​

Path Parameters

    id uuidrequired

    Unique ID of the brand

Body

required

    name string

    A name for the campaign.

    sms_use_case string

    An SMS Use Case category for the campaign (2FA, ACCOUNT_NOTIFICATION, AGENTS_FRANCHISES, CARRIER_EXEMPT, CHARITY, CUSTOMER_CARE, DELIVERY_NOTIFICATION, EMERGENCY, FRAUD_ALERT, HIGHER_EDUCATION, K12_EDUCATION, LOW_VOLUME_MIXED, MARKETING, MIXED, POLITICAL, POLITICAL_SECTION_527, POLLING_VOTING, PROXY, PUBLIC_SERVICE_ANNOUNCEMENT, SECURITY_ALERT, SOCIAL, SWEEPSTAKE, TRIAL, UCAAS_HIGH_VOLUME, UCAAS_LOW_VOLUME).

    sub_use_cases string[]

    A sub use case category for MIXED or LOW_VOLUME_MIXED campaigns (CUSTOMER_CARE, HIGHER_EDUCATION, POLLING_VOTING, PUBLIC_SERVICE_ANNOUNCEMENT, MARKETING, SECURITY_ALERT, 2FA, ACCOUNT_NOTIFICATION, DELIVERY_NOTIFICATION, FRAUD_ALERT).

    campaign_verify_token string

    Campaign Verifiy token. Required if sms use case is POLITICAL_SECTION_527. (Some U.S. wireless carriers require political committees to obtain Campaign Verify verification in order to access special political campaign classes for the new 10DLC text messaging routes. Visit www.campaignverify.org for more information and to obtain your token)

    description string

    A description for the campaign. Please use at least 40 characters.

    sample1 string

    Sample message template/content. At least two samples are required and up to five can be provided. Please use at least 20 characters.

    sample2 string

    Sample 2.

    sample3 string

    Sample 3.

    sample4 string

    Sample 4.

    sample5 string

    Sample 5.

    dynamic_templates string

    If your messaging content will be modified in any way beyond what you shared in your templates, please describe the nature of how the content will change.

    message_flow string

    Please describe the call to action/message flow your intended recipients will experience.

    opt_in_message string

    Please share the message subscribers receive when they opt in.

    opt_out_message string

    Please share the message subscribers receive when they opt out.

    help_message string

    Please share the message subscribers receive when they opt out.

    opt_in_keywords string

    You can share any opt in keywords that subscribers can use here. Default = START

    opt_out_keywords string

    You can share any opt in keywords that subscribers can use here. Default = STOP

    help_keywords string

    You can share any help keywords that subscribers can use here. Default = HELP

    number_pooling_required boolean

    Will 50 or more numbers be used with this single campaign? If so, please enter true.

    number_pooling_per_campaign string

    If you will be using number pooling, please provide an explanation as to why it is needed.

    direct_lending boolean

    Will this campaign include content related to direct lending or other loan agreements?

    embedded_link boolean

    Will you be using an embedded link of any kind? Note that public URL shorteners (bitly, tinyurl) will not be accepted.

    embedded_phone boolean

    Are you using an embedded phone number (except the required HELP information contact phone number)?

    age_gated_content boolean

    Will this campaign include any age gated content as defined by carrier and CTA guidelines?

    lead_generation boolean

    Is there any intent of this campaign to generate leads?

    csp_campaign_reference string

    If you are your own Campaign Service Provider, what is the approved Campaign ID? (Mandatory for CSPs, otherwise please omit)

    status_callback_url string

    Optional: Specify a URL to receive webhook notifications when your campaign’s state changes.

    terms_and_conditions boolean

    I agree to the terms and conditions which do not allow me to use this campaign for affiliate marketing.

Responses​

CREATED

Schema

    id uuidrequired

    The unique id of the campaign.

    name string

    A name for the campaign.

    state string

    The current state of the campaign.

    sms_use_case string

    An SMS Use Case category for the campaign (2FA, ACCOUNT_NOTIFICATION, AGENTS_FRANCHISES, CARRIER_EXEMPT, CHARITY, CUSTOMER_CARE, DELIVERY_NOTIFICATION, EMERGENCY, FRAUD_ALERT, HIGHER_EDUCATION, K12_EDUCATION, LOW_VOLUME_MIXED, MARKETING, MIXED, POLITICAL, POLITICAL_SECTION_527, POLLING_VOTING, PROXY, PUBLIC_SERVICE_ANNOUNCEMENT, SECURITY_ALERT, SOCIAL, SWEEPSTAKE, TRIAL, UCAAS_HIGH_VOLUME, UCAAS_LOW_VOLUME).

    sub_use_cases string[]

    A sub use case category for MIXED or LOW_VOLUME_MIXED campaigns (CUSTOMER_CARE, HIGHER_EDUCATION, POLLING_VOTING, PUBLIC_SERVICE_ANNOUNCEMENT, MARKETING, SECURITY_ALERT, 2FA, ACCOUNT_NOTIFICATION, DELIVERY_NOTIFICATION, FRAUD_ALERT).

    campaign_verify_token string

    Campaign Verifiy token. Required if sms use case is POLITICAL_SECTION_527. (Some U.S. wireless carriers require political committees to obtain Campaign Verify verification in order to access special political campaign classes for the new 10DLC text messaging routes. Visit www.campaignverify.org for more information and to obtain your token)

    description string

    A description for the campaign. Please use at least 40 characters.

    sample1 string

    Sample message template/content. At least two samples are required and up to five can be provided. Please use at least 20 characters.

    sample2 string

    Sample 2.

    sample3 string

    Sample 3.

    sample4 string

    Sample 4.

    sample5 string

    Sample 5.

    dynamic_templates string

    If your messaging content will be modified in any way beyond what you shared in your templates, please describe the nature of how the content will change.

    message_flow string

    Please describe the call to action/message flow your intended recipients will experience.

    opt_in_message string

    Please share the message subscribers receive when they opt in.

    opt_out_message string

    Please share the message subscribers receive when they opt out.

    help_message string

    Please share the message subscribers receive when they opt out.

    opt_in_keywords string

    You can share any opt in keywords that subscribers can use here. Default = START

    opt_out_keywords string

    You can share any opt in keywords that subscribers can use here. Default = STOP

    help_keywords string

    You can share any help keywords that subscribers can use here. Default = HELP

    number_pooling_required boolean

    Will 50 or more numbers be used with this single campaign? If so, please enter true.

    number_pooling_per_campaign string

    If you will be using number pooling, please provide an explanation as to why it is needed.

    direct_lending boolean

    Will this campaign include content related to direct lending or other loan agreements?

    embedded_link boolean

    Will you be using an embedded link of any kind? Note that public URL shorteners (bitly, tinyurl) will not be accepted.

    embedded_phone boolean

    Are you using an embedded phone number (except the required HELP information contact phone number)?

    age_gated_content boolean

    Will this campaign include any age gated content as defined by carrier and CTA guidelines?

    lead_generation boolean

    Is there any intent of this campaign to generate leads?

    csp_campaign_reference string

    If you are your own Campaign Service Provider, what is the approved Campaign ID? (Mandatory for CSPs, otherwise please omit)

    status_callback_url string

    Optional: Specify a URL to receive webhook notifications when your campaign’s state changes.

    created_at date-time
    updated_at date-time
Loading...