Skip to main content
POST
/
v1
/
10dlc
/
campaign
curl -X POST https://api.example.com/v1/10dlc/campaign \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "B4KRR4F",
    "usecase": "CUSTOMER_CARE",
    "description": "Customer support and appointment scheduling for real estate inquiries",
    "messageFlow": "Users opt-in via website contact form with checkbox consent for SMS notifications",
    "sample1": "Hi {'{'}{'{'}}name{'}'}{'}'},your appointment is confirmed. Reply STOP to opt out.",
    "sample2": "Thanks for your inquiry! We will call you shortly. Reply STOP to opt out.",
    "sample3": "Your request has been received. We will respond within 24 hours. Reply STOP to opt out.",
    "directLending": false,
    "ageGated": false,
    "subscriberOptin": true,
    "subscriberOptout": true,
    "subscriberHelp": true,
    "helpMessage": "This is customer support. Reply STOP to opt out or call +15551234567.",
    "optoutMessage": "You have been unsubscribed. No more messages will be sent."
  }'

{
  "campaignId": "C1OTSR2",
  "mnoMetadata": {
    "10017": {
      "mno": "AT&T",
      "qualify": true
    },
    "10035": {
      "mno": "T-Mobile",
      "qualify": true
    }
  },
  "powered_by": "Teli"
}
Create a 10DLC campaign registration with sample messages and compliance details.
Campaign must include at least 3 sample messages and clear opt-in/opt-out messaging.

​
Authorizations

​
X-API-Key
string
required
Authentication header

​
Body

​
brandId
string
required
Brand ID from brand registration
​
usecase
string
required
Campaign use case: CUSTOMER_CARE, 2FA, MARKETING, ACCOUNT_NOTIFICATION
​
description
string
required
Campaign description (40-4096 characters)
​
messageFlow
string
required
How subscribers opt-in (40-4096 characters)
​
sample1
string
required
Sample message 1 (20-1024 characters). Must include opt-out language.
​
sample2
string
required
Sample message 2
​
sample3
string
required
Sample message 3
​
sample4
string
Sample message 4 (optional but recommended)
​
sample5
string
Sample message 5 (optional but recommended)
​
directLending
boolean
Is this for direct lending? Default: false
​
ageGated
boolean
Age-restricted content? Default: false
​
subscriberOptin
boolean
Requires opt-in? Default: true
​
subscriberOptout
boolean
Has opt-out? Default: true
​
subscriberHelp
boolean
Has help keywords? Default: true
​
optinKeywords
string
Opt-in keywords. Default: "START, YES, SUBSCRIBE"
​
optoutKeywords
string
Opt-out keywords. Default: "STOP, QUIT, UNSUBSCRIBE, END"
​
helpKeywords
string
Help keywords. Default: "HELP, INFO"
​
helpMessage
string
Message sent when user requests help (20-320 characters)
​
optoutMessage
string
Message sent when user opts out
curl -X POST https://api.example.com/v1/10dlc/campaign \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "B4KRR4F",
    "usecase": "CUSTOMER_CARE",
    "description": "Customer support and appointment scheduling for real estate inquiries",
    "messageFlow": "Users opt-in via website contact form with checkbox consent for SMS notifications",
    "sample1": "Hi {'{'}{'{'}}name{'}'}{'}'},your appointment is confirmed. Reply STOP to opt out.",
    "sample2": "Thanks for your inquiry! We will call you shortly. Reply STOP to opt out.",
    "sample3": "Your request has been received. We will respond within 24 hours. Reply STOP to opt out.",
    "directLending": false,
    "ageGated": false,
    "subscriberOptin": true,
    "subscriberOptout": true,
    "subscriberHelp": true,
    "helpMessage": "This is customer support. Reply STOP to opt out or call +15551234567.",
    "optoutMessage": "You have been unsubscribed. No more messages will be sent."
  }'

{
  "campaignId": "C1OTSR2",
  "mnoMetadata": {
    "10017": {
      "mno": "AT&T",
      "qualify": true
    },
    "10035": {
      "mno": "T-Mobile",
      "qualify": true
    }
  },
  "powered_by": "Teli"
}

​
Response

​
campaignId
string
Campaign registration ID
​
mnoMetadata
object
Carrier approval status for each carrier (AT&T, T-Mobile, Verizon, etc.)

​
Next Steps

After creating a campaign:
  1. Save the campaignId to your organization
  2. Wait for carrier approval (1-2 days)
  3. Webhook will notify when approved
  4. Phone number assigned automatically