Inbound Status

Check inbound calling configuration for a voice agent.

Endpoint

GET or POST https://www.tabbly.io/api/inbound/status

Authentication

See Introduction.

Your organization must have an active subscription or requests receive HTTP 403.

Phone number is read from the agent record — do not send it in the request.

Query parameters (GET)

Request body (POST)

Example request (GET)

curl "https://www.tabbly.io/api/inbound/status?agent_id=6376" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example request (POST)

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

Response

Success (200)

{
  "status": "success",
  "data": {
    "agent_id": "6376",
    "agent_name": "My Voice Agent",
    "phone_number": "+919876543210",
    "custom_first_line": "Hello, how can I help you?",
    "inbound_active": true,
    "inbound_trunk_id": "ST_...",
    "inbound_dispatch_rule_id": "SDR_..."
  }
}

inbound_active is true when both trunk and dispatch rule IDs are configured, or when a prior inbound call exists for the agent's phone number.

Error responses

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

Workflow

1. Create a voice agent with a purchased phone number.
2. Create Inbound to enable inbound calling.
3. Edit the agent via dashboard or Edit & Delete Agent.
4. Refresh Inbound Metadata after agent changes.
5. Check status anytime with this endpoint.
6. Disable Inbound when done.

Free-tier restriction

The free-tier number 918035736739 is blocked on all inbound endpoints.