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.

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.

business_namestring or nullOptional

Legal/registered business name.

brand_namestring or nullOptional

Public-facing brand name if different from business_name.

website_urlstring or nullOptional

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.

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.

link_samplestring or nullOptional<=255 characters

Example URL if messages contain links.

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

1	import { AgentPhoneClient } from "agentphone";
2
3	async function main() {
4	const client = new AgentPhoneClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.registration.updateA2PRegistration({});
8	}
9	main();

1	{
2	"ok": true,
3	"message": "string",
4	"campaign_status": "string",
5	"updated_fields": [
6	"string"
7	],
8	"sub_account_id": "string"
9	}