Skip to main content
PUT
Update 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"

campaign_id
string
required

The unique ID of the 10DLC Campaign.

Example:

"CKLCK95"

Body

application/json

Fields to update on the 10DLC Campaign. Only included fields are changed.

name
string

Display name of the Campaign.

Maximum string length: 120
Example:

"Campaign"

usecase
enum<string>

Registered use case for the Campaign. One of CUSTOMER_CARE (customer support messaging), MARKETING (promotional content), ACCOUNT_NOTIFICATION (account-related alerts), FRAUD_ALERT (fraud and suspicious-activity warnings), PUBLIC_SERVICE_ANNOUNCEMENT (public-interest notices), or SECURITY_ALERT (security-related warnings).

Available options:
CUSTOMER_CARE,
MARKETING,
ACCOUNT_NOTIFICATION,
FRAUD_ALERT,
PUBLIC_SERVICE_ANNOUNCEMENT,
SECURITY_ALERT
Example:

"MARKETING"

description
string

Description of the Campaign and its messaging purpose.

Required string length: 40 - 4096
Example:

"Explain how users opt in (e.g., via website or paid ads), specify the message frequency, and clearly state that opting in to messages is optional and not required to use the service."

Indicates whether the Campaign messages contain embedded links.

Example:

false

embedded_phones
boolean
default:false

Indicates whether the Campaign messages contain embedded phone numbers.

Example:

false

age_gated
boolean
default:false

Indicates whether the Campaign messages contain age-gated content.

Example:

false

direct_lending
boolean
default:false

Indicates whether the Campaign messages contain direct lending content.

Example:

false

optin
boolean
default:false

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

Example:

true

optout
boolean
default:false

Indicates whether the Campaign provides an opt-out system that subscribers can trigger with a keyword.

Example:

true

help
boolean
default:false

Indicates whether the Campaign provides a help system that subscribers can trigger with a keyword.

Example:

true

sample1
string

Sample message demonstrating the content sent through the Campaign.

Required string length: 20 - 1024
Example:

"Example of message sample for campaign 1"

sample2
string

Sample message demonstrating the content sent through the Campaign.

Required string length: 20 - 1024
Example:

"Example of message sample for campaign 2"

sample3
string

Sample message demonstrating the content sent through the Campaign.

Required string length: 20 - 1024
Example:

"Example of message sample for campaign 3"

sample4
string

Sample message demonstrating the content sent through the Campaign.

Required string length: 20 - 1024
Example:

"Example of message sample for campaign 4"

sample5
string

Sample message demonstrating the content sent through the Campaign.

Required string length: 20 - 1024
Example:

"Example of message sample for campaign 5"

optin_workflow
string

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

Required string length: 40 - 4096
Example:

"Our SMS campaign uses a double opt-in workflow where customers reply START to begin"

help_message
string

Acknowledgement sent when a subscriber texts a help keyword.

Required string length: 20 - 320
Example:

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

optin_message
string

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

Required string length: 20 - 320
Example:

"You have opted in to our campaign. Reply HELP for assistance or STOP to unsubscribe."

optout_message
string

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

Required string length: 20 - 320
Example:

"A comma-separated list of OPT-OUT keywords. The OPT-OUT keywords are case-insensitive."

auto_renewal
boolean
default:true

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

Example:

true

optin_keywords
string

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

Maximum string length: 255
Example:

"start,optin"

help_keywords
string
default:HELP

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

Maximum string length: 255
Example:

"help"

optout_keywords
string

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

Maximum string length: 255
Example:

"optout,discard"

terms_conditions
string

URL of the Campaign terms and conditions.

Maximum string length: 255
Example:

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

privacy_policy
string

URL of the Campaign privacy policy.

Maximum string length: 255
Example:

"PROFESSIONAL"

Sample of an embedded link used in Campaign messages.

Maximum string length: 255
Example:

"https://example.com"

Response

Returns the updated 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: