---
title: "Dispatch Inbound Call"
method: POST
path: "/v1/sip/dispatch"
tags: ["SIP", "SIP"]
---

# Dispatch Inbound Call

`POST /v1/sip/dispatch`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/sip/dispatch`
- Auth: HTTP bearer

Handle incoming SIP call dispatch from LiveKit SIP server.

This endpoint is called by LiveKit when a SIP call comes in.
It looks up the agent bound to the called number and returns
the room configuration.

## Request body

- SIPDispatchRequest: Incoming SIP call dispatch request from LiveKit.
  - `call_id` string, required
  - `from_number` string, required
  - `to_number` string, required
  - `trunk_id` string, nullable

## Response `200`

Successful Response

- SIPDispatchResponse: Response for SIP dispatch - tells LiveKit where to route the call.
  - `room_name` string, required
  - `participant_identity` string, required
  - `participant_name` string, required
  - `metadata` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/call2me/apis/call2me-api.md) · [All operations](https://skmtc.dev/call2me/apis/call2me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call2me/apis/call2me-api/revisions/3951f9b7e47d?raw)