---
title: "Incoming Call"
method: POST
path: "/gemini-live/incoming_call"
tags: ["gemini-live"]
---

# Incoming Call

`POST /gemini-live/incoming_call`

## Request

- Base URL: `https://api.outcallerai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outcallerai.com/gemini-live/incoming_call`
- Auth: none declared

Store metadata for an incoming call and return streaming XML.

## Request body

- IncomingCallBody
  - `from_number` string, nullable
  - `to_number` string, nullable
  - `call_uuid` string, required
  - `call_provider` string
  - `language_code` string, nullable
  - `workspace_id` string, nullable
  - `lead_id` string, nullable
  - `knowledge_base_id` string, nullable
  - `usecase_industry` string, nullable
  - `enable_deviation_tool` boolean
  - `enable_manager_transfer` boolean
  - `telephony_provider` string
  - `system_prompt` string, nullable
  - `voice_id` string
  - `agent_talks_first` boolean
  - `custom_first_message` string, nullable
  - `use_case_id` string, nullable
  - `scheduling_enabled` boolean
  - `outcaller_call_id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-25** `c38469b3aab0`: 2 info
  - added the new optional request property `call_provider`
  - added the new optional request property `language_code`
- **2026-07-31** `7c9aff2501f3`: 2 warning, 2 info
  - removed the request property `campaign_id`
  - removed the request property `campaign_industry`
  - added the new optional request property `use_case_id`
  - added the new optional request property `usecase_industry`
- **2026-07-26** `e7248cb2f50b`: 3 info
  - added the new optional request property `campaign_id`
  - added the new optional request property `outcaller_call_id`
  - added the new optional request property `scheduling_enabled`

[Operation history](https://skmtc.dev/outcallerai/apis/outcallerai-api/changes/gemini-live/incoming_call/post.md)

---

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