Skip to main content
POST
Register a 10DLC Campaign

Authorizations

Authorization
string
header
required

Wavix API key. Pass as Authorization: Bearer <api_key>. Keys support per-resource scopes (none / read / write). See Restricted keys and scopes.

Path Parameters

brand_id
string
required

The unique ID of the 10DLC Brand.

Example:

"BM20QP9"

Body

application/json

Attributes for the new 10DLC Campaign.

affiliate_marketing
boolean
required

Indicates whether the Campaign is used for affiliate marketing.

Example:

false

age_gated
boolean
required

Indicates whether the Campaign messages contain age-gated content.

Example:

false

auto_renewal
boolean
required

Indicates whether the Campaign is automatically renewed at the end of each billing period.

Example:

true

direct_lending
boolean
required

Indicates whether the Campaign messages contain direct lending content.

Example:

true

Indicates whether the Campaign messages contain embedded links.

Example:

true

embedded_phones
boolean | null
required

Indicates whether the Campaign messages contain embedded phone numbers.

Example:

true

Sample of an embedded link used in Campaign messages.

description
string
required

Description of the Campaign and its messaging purpose.

Example:

"Our campaign aims to …"

optin_workflow
string
required

Description of the workflow through which subscribers opt in to the Campaign.

Example:

"Our SMS ..."

help
boolean
required

Indicates whether the Campaign provides a help system that subscribers can trigger with a keyword such as HELP or INFO.

Example:

true

help_keywords
string
required

Comma-separated list of help keywords. Keywords are case-insensitive.

Example:

"help"

help_message
string
required

Acknowledgement sent when a subscriber texts a help keyword.

Example:

"For help, please visit www.site.com. To opt out, reply STOP."

optin
boolean
required

Indicates whether the Campaign requires subscribers to opt in before receiving messages.

Example:

true

optin_keywords
string
required

Comma-separated list of opt-in keywords. Keywords are case-insensitive.

Example:

"begin,start"

optin_message
string
required

Acknowledgement sent when a subscriber texts an opt-in keyword.

Example:

"You are now opted-in for help please reply HELP, to stop please reply STOP"

optout
boolean
required

Indicates whether the Campaign provides an opt-out system that subscribers can trigger with a keyword such as STOP or QUIT.

Example:

true

optout_keywords
string
required

Comma-separated list of opt-out keywords. Keywords are case-insensitive.

Example:

"stop,quit,unsubscribe"

optout_message
string
required

Acknowledgement sent when a subscriber texts an opt-out keyword.

Example:

"You are now opted out and will receive no further messages"

name
string
required

Display name of the Campaign.

Example:

"My first campaign"

sample1
string
required

Sample message demonstrating the content sent through the Campaign.

Example:

"Your verification code is XXXXXX"

sample2
string | null
required

Sample message demonstrating the content sent through the Campaign.

sample3
string | null
required

Sample message demonstrating the content sent through the Campaign.

sample4
string | null
required

Sample message demonstrating the content sent through the Campaign.

sample5
string | null
required

Sample message demonstrating the content sent through the Campaign.

mock
boolean
required

Indicates whether the Campaign is a mock campaign used for testing. Mock campaigns cannot send production traffic.

Example:

false

usecase
string
required

Registered use case for the Campaign, such as 2FA or MARKETING.

Example:

"2FA"

terms_conditions
string
required

URL of the Campaign terms and conditions.

Example:

"https://site.com/terms-and-conditions"

privacy_policy
string

URL of the Campaign privacy policy.

Example:

"https://site.com/privacy-policy"

Response

Returns the registered 10DLC Campaign.

Represents a 10DLC campaign registered under a Brand. A Campaign defines the messaging use case, opt-in and opt-out flows, and the phone numbers permitted to send its traffic.

affiliate_marketing
boolean
required

Indicates whether the Campaign is used for affiliate marketing.

Example:

false

age_gated
boolean
required

Indicates whether the Campaign messages contain age-gated content.

Example:

false

auto_renewal
boolean
required

Indicates whether the Campaign should be automatically renewed.

Example:

true

last_bill_date
string | null
required

Date and time the Campaign was last billed in ISO 8601 format. null if the Campaign has never been billed.

Example:

"2024-08-14T11:57:42"

next_bill_date
string | null
required

Date and time the Campaign will be billed next in ISO 8601 format. null if the next billing date is not scheduled.

Example:

"2024-08-14T11:57:42"

direct_lending
boolean
required

Indicates whether the Campaign messages contain direct lending content.

Example:

true

Indicates whether the Campaign messages contain embedded links.

Example:

true

embedded_phones
boolean
required

Indicates whether the Campaign messages contain embedded phone numbers.

Example:

true

Sample of an embedded link used in Campaign messages.

brand_id
string
required

Unique identifier of the Brand that owns the Campaign.

Example:

"BM20QP9"

campaign_id
string
required

Unique identifier of the Campaign assigned by the registry.

Example:

"CKLCK95"

description
string | null
required

Description of the Campaign and its messaging purpose.

Example:

"Our campaign aims to …"

optin_workflow
string | null
required

Description of the workflow through which subscribers opt in to the Campaign.

Example:

"Our SMS ..."

feedback
string | null
required

Feedback from the registry explaining the current status.

help
boolean
required

Indicates whether the campaign includes a help system (for example, keyword: HELP, INFO).

Example:

true

help_keywords
string
required

Comma-separated list of help keywords. Keywords are case-insensitive.

Example:

"help"

help_message
string | null
required

Help message sent upon receiving a help keyword.

Example:

"For help, please visit www.site.com. To opt out, reply STOP."

optin
boolean
required

Indicates whether the Campaign requires subscriber opt-in.

Example:

true

optin_keywords
string
required

Comma-separated list of opt-in keywords. Keywords are case-insensitive.

Example:

"begin,start"

optin_message
string | null
required

Opt-in message sent upon receiving an opt-in keyword.

Example:

"You are now opted-in for help please reply HELP, to stop please reply STOP"

optout
boolean
required

Indicates whether the campaign includes an opt-out system (for example, keyword: STOP, QUIT).

Example:

true

optout_keywords
string
required

Comma-separated list of opt-out keywords. Keywords are case-insensitive.

Example:

"stop,quit,unsubscribe"

optout_message
string | null
required

Opt-out message sent upon receiving an opt-out keyword.

Example:

"You are now opted out and will receive no further messages"

name
string
required

Display name of the Campaign.

Example:

"My first campaign"

created_at
string
required

Timestamp when the Campaign was created, in ISO 8601 format.

Example:

"2024-08-14T11:57:41"

sample1
string | null
required

Sample message demonstrating the content sent through the Campaign.

Example:

"Your verification code is XXXXXX"

sample2
string | null
required

Sample message demonstrating the content sent through the Campaign.

sample3
string | null
required

Sample message demonstrating the content sent through the Campaign.

sample4
string | null
required

Sample message demonstrating the content sent through the Campaign.

sample5
string | null
required

Sample message demonstrating the content sent through the Campaign.

updated_at
string
required

Timestamp when the Campaign was last updated, in ISO 8601 format.

Example:

"2024-08-14T11:57:47"

mock
boolean
required

Indicates whether the Campaign is a mock campaign used for testing. Mock campaigns cannot send production traffic.

Example:

false

usecase
string
required

Registered use case for the Campaign, such as 2FA or MARKETING.

Example:

"2FA"

monthly_fee
string
required

Recurring monthly fee charged for the Campaign, as a decimal string.

Example:

"10.0"

privacy_policy
string | null
required

Privacy policy URL.

Example:

"https://site.com/privacy-policy"

terms_conditions
string | null
required

Terms and conditions URL.

Example:

"https://site.com/terms-and-conditions"

status
string
required

Current registration status of the Campaign, such as APPROVED or PENDING.

Example:

"APPROVED"

phone_numbers
string[]
required

Phone numbers assigned to the Campaign, in E.164 format.

Example: