Skip to navigation
API Referenceregistration

Update A2P Registration

Update an existing A2P 10DLC registration.

Send only the fields that changed — everything is optional. There is no fee. Changes are applied after review, and your registration keeps sending under its current approval while an update to an approved registration is reviewed.

Registrations created with create_sub_account=true (the default) live on a sub-account; this resolves to it automatically when there’s exactly one, or honors the X-Sub-Account-Id header.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
first_namestring or nullOptional
Contact first name.
last_namestring or nullOptional
Contact last name.
emailstring or nullOptional
Contact email address.
phone_numberstring or nullOptional

E.164 format, e.g. +15551234567

business_namestring or nullOptional

Legal/registered business name.

brand_namestring or nullOptional

Public-facing brand name if different from business_name.

organization_typeenum or nullOptional
Organization type.
contact_titleenum or nullOptional
Your role.
contact_title_otherstring or nullOptional

Custom title when contact_title is 'other'.

einstring or nullOptional

EIN / Tax ID.

website_urlstring or nullOptional
industrystring or nullOptional

e.g. technology, real_estate, retail, healthcare

business_regionslist of strings or nullOptional

e.g. ['usa_and_canada']

street_addressstring or nullOptional
Street address line 1.
street_address_2string or nullOptional

Street address line 2 (suite, unit, etc.).

citystring or nullOptional
City.
statestring or nullOptional

State/region code.

zip_codestring or nullOptional

Postal/ZIP code.

countrystring or nullOptional
Country code, e.g. US.
descriptionstring or nullOptional40-4096 characters
What your business does, who you message, and what types of messages you send. Min 40 chars.
use_caseslist of enums or nullOptional

1-5 specific use cases for your SMS campaign.

volumeenum or nullOptional
Expected message volume.
Allowed values:
message_sampleslist of strings or nullOptional

2-5 example messages. Each must be 20-1024 chars and include your brand name.

consent_flowstring or nullOptional40-4096 characters
How users opt in to receive messages. Min 40 chars.
privacy_policy_urlstring or nullOptional
terms_of_service_urlstring or nullOptional
opt_in_image_urlstring or nullOptional

Publicly accessible URL to a screenshot of your opt-in flow (PNG, JPG, WEBP, or GIF, max 2MB)

includeslist of enums or nullOptional
Content types included in messages.
Allowed values:

Response

Successful Response
okboolean
messagestring
campaign_statusstring
updated_fieldslist of strings
sub_account_idstring or nullOptional

Set when the update was applied to a registration on a sub-account of the calling account (the default for POST /v1/register).

Errors

422
Unprocessable Entity Error