---
title: "Handle Inbound Calls"
method: POST
path: "/call"
---

# Handle Inbound Calls

`POST /call`

## Request

- Base URL: `https://api.phonely.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.phonely.ai/call`
- Auth: none declared

Handles incoming call-related requests for different message types.
Supported message types are:
- assistant-request: Sets up the AI assistant for the call, initializes call data and cache, and returns assistant configuration
- status-update: Processes call status changes like call ending or forwarding
- end-of-call-report: Triggers background processing of call completion, including transcripts, recordings, and post-call actions

## Headers

- `authorization` string, nullable
- `x-internal-api-key` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/phonely/apis/phonely-api.md) - [All operations](https://skmtc.dev/phonely/apis/phonely-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phonely/apis/phonely-api/revisions/9bfd5599d479?raw)