Skip to main content
POST
Ask for a code to link your phone

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
timezone
string
required

Your IANA timezone, such as America/New_York, as your browser names it: your agent runs in it once the phone is linked.

Required string length: 1 - 64

Response

Created

code
string
required

Text it, alone, to line_e164 from the phone to link.

Pattern: ^[A-HJ-NP-Z2-9]{6}$
expires_at
string<date-time>
required

When the code stops working; ask for a new one then.

line_e164
string
required

The number to text the code to, in E.164.

refusal
enum<string>

Why the last text of the code linked nothing: phone_linked_to_another_account, the phone is another account's; not_allowlisted, your account is not on the personal agent allowlist.

Available options:
phone_linked_to_another_account,
not_allowlisted