Skip to main content
POST
Assign a phone number

Authorizations

X-API-Key
string
header
required

API key for external access. Format: tp_live_<32-hex-chars>. Create keys in the TalkPilot Dashboard under Settings > API.

Path Parameters

agentId
string<uuid>
required

Agent UUID

Body

application/json
source
enum<string>
required

Where the number comes from. Only pool is supported.

Available options:
pool

Response

Phone number assigned

phone_number
string
required

Assigned number in E.164 format

pool_remaining
integer
required

Number of pool numbers that are still assignable afterwards