---
title: "Call ringing event"
method: POST
path: "call_ringing"
tags: ["webhook"]
---

# Call ringing event

`POST call_ringing` (webhook)

Incoming call webhook, triggered when you receive a call. You will retrieve all the call's information and if it's to a voice server, you'll also have the information related to it in the object <em>ivr_data</em>.

To certify that the request was sent by Ringover, verify the request signature with your webhook key — see **Securing your webhooks** under the `webhook` tag (V1: JWT `HS512` in `X-Ringover-Webhook-Signature`, with the deprecated `Authorization` header for backward compatibility; V3, on request: Base64 HMAC-SHA256 in `X-Ringover-Webhook-Signature-V3`).

## Payload

- WebhookRequestCallRinging
  - `event` string
  - `resource` string
  - `timestamp` number
  - `data` object
    - `id` string
    - `call_id` integer
    - `channel_id` integer
    - `start_time` number
    - `direction` 'inbound' | 'outbound'
    - `from_number` string
    - `to_number` string
    - `user_id` integer
    - `is_internal` boolean — The call is coming from an internal number.
    - `is_anonymous` boolean
    - `is_ivr` boolean — The call is coming from an IVR.
    - `ivr_data` WebhookIvr
      - `number` string
      - `scenario_name` string
      - `ivr_name` string
    - `user` object
      - `user_id` integer
      - `firstname` string
      - `lastname` string
      - `email` string
      - `photo` string
    - `status` string
  - `attempt` integer

## Acknowledgement `200`

Successful operation

## Other responses

- `default` — Other response code are ignored

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)