5f4eb30ac29a

latestOpenAPI 3.1.02026-08-1057178174.9 KB
authentication

Register a phone number

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.

post/api/v1/auth/register-number

Request body

registrationIdstring required

From the verify-sign-up response.

phoneNumberstring required

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

Response

Code sent.

registrationIdstring
phoneNumberstring

The number in canonical E.164 form.

status'pending'