Create a sender registration

Creates a sender registration and sets status to PENDING_APPROVAL.

  • If the account does not use parent/child accounts, the API ignores child_account_id and registers the sender for the authenticated account.
  • If the account is a parent account and you omit child_account_id, the API registers the sender for the parent account.
  • If you provide child_account_id, the API registers the sender for that child account.
  • If a registration for the same sender was already created within the last 30 minutes (for the same account or child account), the API returns 429 Too Many Requests. This prevents abuse of the verification retry limit.
  • Any existing PENDING_APPROVAL registration for the same sender (for the same account or child account) is automatically cancelled before the new one is created.
Body Params
string
required

The sender number to register, for example a phone number.

string
required
length between 2 and 2

ISO 3166-1 alpha-2 country code for the sender, for example AU.

string
enum
required

Type of sender registration.

Allowed:
string

Child account ID to register the sender for. Ignored for accounts without parent/child accounts. If omitted for a parent account, the API registers the sender for the parent account.

Responses

Language
Credentials
Header
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json