Create Inbound

Enable inbound calling for a voice agent's phone number.

Prerequisite: Create a voice agent with a purchased phone number using Create Agent.

Endpoint

POST https://www.tabbly.io/api/inbound/create

Authentication

See Introduction. This is a POST endpoint — include api_key in the JSON request body.

Request body

Parameter	Type	Required	Description
`api_key`	string	Yes	Your organization API key
`agent_id`	string	Yes	Voice agent ID

Example request

curl -X POST "https://www.tabbly.io/api/inbound/create" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "agent_id": "6376"
  }'

Response

Success (200)

{
  "status": "success",
  "data": {
    "action": "created",
    "agent_id": "6376",
    "voice_agent_id": "6376",
    "phone_number": "+919876543210",
    "inbound_trunk_id": "ST_...",
    "inbound_dispatch_rule_id": "SDR_...",
    "tabbly_trunk_id": "...",
    "tabbly_trunk_created": true,
    "inbound_active": true
  }
}

Error responses

{
  "status": "error",
  "message": "Human-readable error description"
}

HTTP status	When
400	Missing fields
401	Invalid or missing API key
403	Wrong org, inactive subscription, or free-tier phone blocked
404	Agent not found
409	Phone number already has inbound on another agent
502	Inbound trunk creation failed