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](#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

Errors

400
Bad Request Error
409
Conflict Error
429
Too Many Requests Error