For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDashboard
DocsAPI ReferenceWebhooksMethodsUI ComponentsMCP ServerChangelog
  • Documentation
    • Introduction
    • Authentication
    • RCS Support
  • Quickstart
    • SMS
    • RCS
  • Guides
    • Purchase Phone Numbers
    • Brands
    • Campaigns
      • 10DLC Campaigns
      • Toll-Free Campaigns
      • RCS Campaigns
      • SMS Opt-In Compliance
      • RCS Campaign Compliance
    • Messages
    • Branded Test Agents
    • Handling Expired URLs
LogoLogo
SupportDashboard
On this page
  • Prerequisites
  • Step 1: Create or update the campaign
  • Step 2: Submit for carrier review
  • Step 3: Watch review progress
  • Step 4: Attach numbers and start sending messages
  • Send messages
GuidesCampaigns

Toll-Free Campaigns

Was this page helpful?
Previous

RCS Campaigns

Next
Built with

Follow the sequence below to enable high-throughput toll-free messaging across the US.

⏱️ Approval time: Less than 10 minutes

Prerequisites

  • An approved brandId (register one here)
  • Documented opt-in evidence
  • Sample outbound message and contact details

Step 1: Create or update the campaign

  • Call POST /campaigns/toll-free with the brand, use case, consent flow, and compliance metadata.
Optional helpers

  • POST /campaigns/toll-free/autofill fills in the campaign information based on the existing information for a campaign and its brand.

  • POST /campaigns/toll-free/validate surfaces formatting and campaign issues. Treat the response as guidance only; it never blocks campaign submission but is intended to guide you.

Step 2: Submit for carrier review

  • Call POST /campaigns/toll-free/submit/{campaignId} to submit the campaign for carrier review.

Step 3: Watch review progress

  • Pull the full record and its status with GET /campaigns/toll-free/{campaignId}.
  • Force a status refresh using GET /status/toll-free-campaign/{campaignId}.

Step 4: Attach numbers and start sending messages

If you don’t have a number yet, follow our phone numbers guide to purchase one.

Attach owned numbers to the campaign via POST /phone-numbers/attach-campaign. Note that each toll-free number is carrier reviewed and thus takes more time. In some cases, a number may fail to be attached to the campaign and you’ll be asked to update the campaign and reattach the number.

  • Processing time: 1-3 business days
  • Status check: GET /status/toll-free-campaign/{campaignId}

Send messages

Start messaging with POST /messages/send/sms or POST /messages/send/mms. While waiting for approval, you’ll also be able to send test messages with our sandbox numbers. See our sending messages guide for detailed instructions on sending messages.