v50

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-06-16122182589.7 KB

10DLC

Update a 10DLC Campaign

Updates the 10DLC Campaign identified by campaign_id. Only the provided fields are changed.

put/v3/10dlc/brands/{brand_id}/campaigns/{campaign_id}

Path parameters

brand_idstring required

Example:BM20QP9

The unique ID of the 10DLC Brand.

campaign_idstring required

Example:CKLCK95

The unique ID of the 10DLC Campaign.

Request body

namestring

Display name of the Campaign.

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).

descriptionstring

Description of the Campaign and its messaging purpose.

embedded_linksboolean

Indicates whether the Campaign messages contain embedded links.

embedded_phonesboolean

Indicates whether the Campaign messages contain embedded phone numbers.

age_gatedboolean

Indicates whether the Campaign messages contain age-gated content.

direct_lendingboolean

Indicates whether the Campaign messages contain direct lending content.

optinboolean

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

optoutboolean

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

helpboolean

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

sample1string

Sample message demonstrating the content sent through the Campaign.

sample2string

Sample message demonstrating the content sent through the Campaign.

sample3string

Sample message demonstrating the content sent through the Campaign.

sample4string

Sample message demonstrating the content sent through the Campaign.

sample5string

Sample message demonstrating the content sent through the Campaign.

optin_workflowstring

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

help_messagestring

Acknowledgement sent when a subscriber texts a help keyword.

optin_messagestring

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

optout_messagestring

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

auto_renewalboolean

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

optin_keywordsstring

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

help_keywordsstring

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

optout_keywordsstring

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

terms_conditionsstring

URL of the Campaign terms and conditions.

privacy_policystring

URL of the Campaign privacy policy.

embedded_link_samplestring

Sample of an embedded link used in Campaign messages.

Example request

{
  "name": "Campaign",
  "usecase": "MARKETING",
  "description": "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.",
  "optin": true,
  "optout": true,
  "help": true,
  "sample1": "Example of message sample for campaign 1",
  "sample2": "Example of message sample for campaign 2",
  "sample3": "Example of message sample for campaign 3",
  "sample4": "Example of message sample for campaign 4",
  "sample5": "Example of message sample for campaign 5",
  "optin_workflow": "Our SMS campaign uses a double opt-in workflow where customers reply START to begin",
  "help_message": "For help, please visit www.site.com. To opt out, reply STOP.",
  "optin_message": "You have opted in to our campaign. Reply HELP for assistance or STOP to unsubscribe.",
  "optout_message": "A comma-separated list of OPT-OUT keywords. The OPT-OUT keywords are case-insensitive.",
  "auto_renewal": true,
  "optin_keywords": "start,optin",
  "help_keywords": "help",
  "optout_keywords": "optout,discard",
  "terms_conditions": "https://site.com/terms-and-conditions",
  "privacy_policy": "PROFESSIONAL",
  "embedded_link_sample": "https://example.com"
}

Response

Returns the updated 10DLC Campaign.

affiliate_marketingboolean required

Indicates whether the Campaign is used for affiliate marketing.

age_gatedboolean required

Indicates whether the Campaign messages contain age-gated content.

auto_renewalboolean required

Indicates whether the Campaign should be automatically renewed.

last_bill_datestring nullable required

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

next_bill_datestring nullable required

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

direct_lendingboolean required

Indicates whether the Campaign messages contain direct lending content.

embedded_linksboolean required

Indicates whether the Campaign messages contain embedded links.

embedded_phonesboolean required

Indicates whether the Campaign messages contain embedded phone numbers.

embedded_link_samplestring nullable required

Sample of an embedded link used in Campaign messages.

brand_idstring required

Unique identifier of the Brand that owns the Campaign.

campaign_idstring required

Unique identifier of the Campaign assigned by the registry.

descriptionstring nullable required

Description of the Campaign and its messaging purpose.

optin_workflowstring nullable required

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

feedbackstring nullable required

Feedback from the registry explaining the current status.

helpboolean required

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

help_keywordsstring required

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

help_messagestring nullable required

Help message sent upon receiving a help keyword.

optinboolean required

Indicates whether the Campaign requires subscriber opt-in.

optin_keywordsstring required

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

optin_messagestring nullable required

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

optoutboolean required

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

optout_keywordsstring required

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

optout_messagestring nullable required

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

namestring required

Display name of the Campaign.

created_atstring required

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

sample1string nullable required

Sample message demonstrating the content sent through the Campaign.

sample2string nullable required

Sample message demonstrating the content sent through the Campaign.

sample3string nullable required

Sample message demonstrating the content sent through the Campaign.

sample4string nullable required

Sample message demonstrating the content sent through the Campaign.

sample5string nullable required

Sample message demonstrating the content sent through the Campaign.

updated_atstring required

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

mockboolean required

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

usecasestring required

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

monthly_feestring required

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

privacy_policystring nullable required

terms_conditionsstring nullable required

Terms and conditions URL.

statusstring required

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

phone_numbersstring[] required

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

Example response

{
  "affiliate_marketing": false,
  "age_gated": false,
  "auto_renewal": false,
  "brand_id": "BM20QP9",
  "campaign_id": "CKLCK95",
  "created_at": "2024-08-14T11:57:41",
  "description": "Our campaign aims to …",
  "direct_lending": false,
  "embedded_link_sample": null,
  "embedded_links": false,
  "embedded_phones": false,
  "feedback": null,
  "help": true,
  "help_keywords": "help",
  "help_message": "For help, please visit www.site.com. To opt-out, reply STOP.",
  "last_bill_date": "2024-08-14T11:57:42",
  "mock": false,
  "monthly_fee": "10.0",
  "name": "My first campaign",
  "next_bill_date": "2024-11-14T00:00:00",
  "optin": true,
  "optin_keywords": "begin,start",
  "optin_message": "You are now opted-in for help please reply HELP, to stop please reply STOP",
  "optin_workflow": "Our SMS ...",
  "optout": true,
  "optout_keywords": "stop,quit,unsubscribe",
  "optout_message": "You are now opted out and will receive no further messages",
  "privacy_policy": "https://site.com/privacy-policy",
  "sample1": "Your verification code is XXXXXX",
  "sample2": "XXXX is your verification code",
  "sample3": null,
  "sample4": null,
  "sample5": null,
  "status": "APPROVED",
  "terms_conditions": "https://site.com/terms-and-conditions",
  "updated_at": "2024-08-14T11:57:47",
  "usecase": "2FA",
  "phone_numbers": []
}