Skip to navigation
REST APIAuthentication

Register a phone number

View as Markdown

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.

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