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

# Incoming Call

`POST /gemini-live/incoming_call`

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
  - `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

---

[API](https://skmtc.net/outcallerai/apis/fastapi.md) · [All operations](https://skmtc.net/outcallerai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outcallerai/fastapi/revisions/2e4355d35497/schema)