> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev.setoo.work/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbound Quickstart

> Configure a number to receive calls in five minutes

Route an incoming call on a purchased number to an agent.

<Steps>
  <Step title="Purchase or bring a number">
    See [Purchase Phone Numbers](/docs/guides/numbers/purchase-phone-numbers).
  </Step>

  <Step title="Register the number, bound to an agent">
    Registering a number under a telephony provider's integration is what binds it
    to an agent for inbound calls:

    ```bash theme={null}
    curl -X POST https://api.agentic-os.com/api/v1/voice-numbers \
      -H "Authorization: Bearer $AGENTIC_OS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "provider": "PLIVO",
        "number": "912269976288",
        "connectionId": "YOUR_PLIVO_INTEGRATION_ID",
        "agentId": "AGENT_ID"
      }'
    ```

    `connectionId` is the ID of your connected telephony integration — list your
    integrations with `GET /integrations` (platform-core) to find it.
  </Step>

  <Step title="Call the number">
    Dial the number from any phone — the assigned agent answers automatically.
  </Step>
</Steps>

See [Receive Incoming Calls](/docs/guides/inbound/receive-incoming-calls) for IVR-style
routing across multiple agents.