Skip to content
DashboardGet API key

Create 10DLC campaign

View .md
POST

Create a 10DLC campaign under an existing brand. The campaign starts in draft status. Submit it for carrier review using the submit endpoint.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Body

application/json

  • brandIdstringrequired

    ID of the brand to create this campaign under.

  • namestringrequired
    Limitsmax length 100
  • useCasestringrequired

    Campaign use case (e.g., ACCOUNT_NOTIFICATION, MARKETING, 2FA).

    Limitsmax length 50
  • subUseCasesstring[]
  • descriptionstringrequired
    Limitsmax length 4096
  • sampleMessagesstring[]required
    Limitsmin items 1 · max items 5
  • subscriberOptInbooleanrequired
  • subscriberOptOutbooleanrequired
  • subscriberHelpbooleanrequired
  • numberPoolingbooleanrequired
  • directLendingbooleanrequired
  • embeddedLinkbooleanrequired
  • embeddedPhonebooleanrequired
  • affiliateMarketingbooleanrequired
  • ageGatedbooleanrequired
  • messageFlowstring
    Limitsmax length 2048
  • helpMessagestring
    Limitsmax length 500
  • optInKeywordsstring[]
  • optOutKeywordsstring[]

Responses

201Campaign created in draft status.
  • campaignobjectrequired
    29 properties
    • idstringrequired
    • brandIdstringrequired

      ID of the brand this campaign belongs to.

    • namestringrequired
    • useCasestringrequired

      Campaign use case type.

    • subUseCasesstring[]nullable
    • descriptionstringrequired

      Description of the messaging campaign.

    • sampleMessagesstring[]required

      Sample messages representative of campaign content.

    • subscriberOptInbooleanrequired
    • subscriberOptOutbooleanrequired
    • subscriberHelpbooleanrequired
    • numberPoolingbooleanrequired
    • directLendingbooleanrequired
    • embeddedLinkbooleanrequired
    • embeddedPhonebooleanrequired
    • affiliateMarketingbooleanrequired
    • ageGatedbooleanrequired
    • messageFlowstringnullable
    • helpMessagestringnullable
    • optInKeywordsstring[]nullable
    • optOutKeywordsstring[]nullable
    • statusstringrequired

      Status of a 10DLC campaign registration.

      • draft: created, not yet submitted.
      • pending: submitted, awaiting the carriers. Re-read from the carrier every 30 minutes, so it moves on its own.
      • approved: SMS to +1 numbers can go out from numbers assigned to it. The monthly fee is charged while it is approved.
      • rejected: refused by the carriers. The one-time registration fee is refunded.
      • failed: the registration did not reach the carriers. The fee is refunded.
      • expired: was approved and has lapsed.
      One ofdraftpendingapprovedrejectedexpiredfailed
    • dailyLimitintegernullable

      Daily message limit based on brand trust score.

    • failureReasonstringnullable
    • registrationCostCentsintegernullable

      One-time registration cost in cents.

    • monthlyFeeCentsintegernullable

      Recurring monthly fee in cents.

    • submittedAtstring<date-time>nullable
    • approvedAtstring<date-time>nullable
    • createdAtstring<date-time>required
    • updatedAtstring<date-time>required
400Invalid request.
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Brand not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject