Assign a number to an agent

POST

/api/phone-numbers/{numberId}/assign

Assigns one of the tenant's phone numbers to one of the tenant's agents and sets up inbound call routing for that mapping.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Number assigned to the agent.

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/phone-numbers//assign' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "agentId": "bc309ecf-5f66-4057-93c5-6611cc9cb7b2"
}'

Response Example

200 - Example 1

{
    "message": "Phone number assigned successfully",
    "phone_number": "+4712345678",
    "agent": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
    },
    "dispatch_rule_id": "string",
    "note": "Call routing rule created automatically!"
}

Modified at 2026-07-08 19:01:40

Purchase a phone number

Unassign a number from its agent