Skip to content
DashboardGet API key

Submit 10DLC campaign for review

View .md
POST

The team must have an approved Business Verification (KYB): submitting without one returns 403 with code kyb_required. Submit a draft campaign for carrier review. The campaign must be in draft status and its brand must be verified. TCR's one-time registration fee is charged from your balance at submission ($15 for standard use cases, $2 for LOW_VOLUME), passed through at cost and refunded if the carrier rejects it. Once approved, the campaign's monthly TCR fee ($10 standard, $2 LOW_VOLUME) is charged from your balance while the campaign is active — see registrationCostCents and monthlyFeeCents on the campaign object.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • campaignIdstringrequired

    10DLC campaign ID.

Responses

200Campaign submitted for review.
  • 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
400Campaign already submitted or invalid status.
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
402The balance cannot cover the one-time registration fee, so nothing was charged and nothing reached the carrier. Add funds and submit again.
  • codestringrequired
  • messagestringrequired
  • detailsobject
403Business verification (KYB) is not approved. Carriers register 10DLC against a vetted legal entity, so registration is blocked until it is.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Campaign not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject