Register a phone number | Dial — Communication Stack for AI Agents

Sends a one-time code by SMS to the phone number that will own the new account. Call this with the registrationId returned by Verify a sign-up code.

The number must be a valid phone number in E.164 form, and it must not already be registered to another account — a verified number is bound to one account permanently. A Dial number cannot be used to register a Dial account.

Calling this again with the same number re-sends the code. Calling it with a different number replaces the pending one, so a mistyped number is recoverable until it is verified.

Sends a one-time code by SMS to the phone number that will own the new account. Call this with the `registrationId` returned by [Verify a sign-up code](#operation/verifySignup). The number must be a valid phone number in E.164 form, and it must not already be registered to another account — **a verified number is bound to one account permanently.** A Dial number cannot be used to register a Dial account. Calling this again with the same number re-sends the code. Calling it with a different number replaces the pending one, so a mistyped number is recoverable until it is verified.

Request

This endpoint expects an object.

registrationIdstringRequired

From the verify-sign-up response.

phoneNumberstringRequired

The owner's phone number, E.164 preferred.

Response

Code sent.

registrationIdstringOptional

phoneNumberstringOptional

The number in canonical E.164 form.

statusenumOptional

Allowed values:

Errors

400

Bad Request Error

409

Conflict Error

429

Too Many Requests Error