Docs / Get started

Messaging registration (10DLC)

US carriers only deliver business texts from senders registered with The Campaign Registry (TCR). The Messaging API sends for your account once your registration is approved — so it's the first thing to do.

Why it's needed

Texts a business sends from an ordinary ten-digit number (a 10DLC, "10-digit long code") are application-to-person messaging. Carriers require every such sender to register its business and describe the messages it sends — a campaign — with TCR. Unregistered traffic is filtered or blocked, so Phound doesn't send it.

Register

  1. Sign in and open Registration in the dashboard.
  2. Fill in your business — its legal name and tax ID (EIN), address and website — and its contacts.
  3. Describe your messages: what you'll send, how people opt in to receive them, with links to screenshots of the opt-in, and a few sample messages.
  4. Submit. Phound reviews it, usually within a few business days.

Already registered through Phound Wave or Phound Business? That registration counts here too.

The dashboard submits it with the Account API's POST /10dlc-registration, which an app of your own can call too when a Phound user signs in to it — it needs their OAuth token with the account:write scope, never an API key. See the Account API reference.

What reviewers check most

That people clearly agree to get your texts (a box that isn't ticked for them, wording that says what they'll receive), that your website and legal name match, and that each sample message names your business and says how to opt out (Reply STOP to opt out).

Status

StatusMeaningCan send
not_submittedNo registration yet.No
submittedBeing reviewed.No
approvedRegistered.Yes
deniedRefused. Correct it and submit it again.No

The dashboard shows it, and your code can read it in the account, from the Account API with a key that has account:read:

curl https://api.phound.app/accounts/v1/account \
  -H "Authorization: Bearer $PHOUND_KEY"
{
  "object": "account",
  …
  "registrations": {
    "us_10dlc": { "object": "us_10dlc_registration", "status": "submitted", "can_send": false }
  }
}

Sending before it's approved

Everything except sending works while you wait: numbers, API keys, webhooks, reading conversations. A send is refused before anything goes out, with 403:

{
  "title": "10DLC registration required",
  "status": 403,
  "code": "registration_required",
  "group": "compliance",
  "retryable": false,
  "owner_action_required": true,
  "detail": "Your 10DLC registration was submitted and is being reviewed. You can send once it's approved.",
  "next_step": "Register your business for 10DLC messaging in the Phound developer portal: https://developers.phound.app/dashboard/registration"
}

Retrying won't help until the status is approved; nothing is sent and nothing is billed.