---
title: "POST realtime_call_incoming"
method: POST
path: "realtime_call_incoming"
---

# POST realtime_call_incoming

`POST realtime_call_incoming` (webhook)

Sent when an incoming API SIP session is available for Realtime acceptance.

## Payload

- WebhookRealtimeCallIncoming — Sent when an incoming API SIP session is available for Realtime acceptance. The same pending session can also emit `live.transport.incoming`; the first successful Realtime or Live accept endpoint selects the runtime surface.
  - `created_at` integer, required — The Unix timestamp (in seconds) of when the model response was completed.
  - `id` string, required — The unique ID of the event.
  - `data` object, required — Event data payload.
    - `call_id` string, required — The ID of the pending SIP call. Pass this value unchanged when accepting or rejecting the call through the Realtime API. For the Live API, use the `session_id` from `live.transport.incoming` instead.
    - `sip_media_security` union — Media protection selected on the SIP leg during SDP negotiation. `srtp` indicates SRTP; `rtp` indicates unencrypted RTP. Omitted when unknown. This does not describe SIP signaling security or confirm that media has flowed. Clients should handle unrecognized values as unknown.
      - 'rtp' | 'srtp'
      - string
    - `sip_headers` object[], required — Headers from the SIP INVITE, excluding SIP authorization headers. Retained names, values, repeated entries, and order are preserved. Treat these values as untrusted call metadata.
      - `name` string, required — Name of the SIP Header.
      - `value` string, required — Value of the SIP Header.
  - `object` 'event' — The object of the event. Always `event`.
  - `type` 'realtime.call.incoming', required — The type of the event. Always `realtime.call.incoming`.

## Acknowledgement `200`

Return a 200 status code to acknowledge receipt of the event. Non-200
status codes will be retried.

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/openai/apis/openapi/revisions/4b75527da17b?raw)
