---
title: "Initiate a callback through an IVR"
method: POST
path: "/ivrs/{ivrId}/callback"
tags: ["callbacks", "ivrs"]
---

# Initiate a callback through an IVR

`POST /ivrs/{ivrId}/callback`

Triggers a callback through a specific IVR (Interactive Voice Response) queue. The specified phone number will be called, and when the recipient picks up, they are routed through the IVR flow associated with the given `ivrId`. This is typically used to offer a "call me back" feature to customers waiting in a queue.

IVR Callbacks are only available on the **Business** and **Advanced** plans. Standard telephony charges apply based on the destination number.

**Permission:** `Calls Write` required.

**Monitoring:** Not required for this route. Any valid API key with `Calls Write` permission can initiate an IVR callback regardless of the Monitoring flag.

## Path parameters

- `ivrId` integer, required

## Request body

- RequestIvrCallback
  - `from_number` integer — The IVR Number to display
  - `clir` boolean — Calling line identification restriction: The CLIR service blocks calling party address information from being presented to the called user.
  - `to_number` integer
  - `timeout` integer — Number of seconds before the call is aborted if the communication isn't etablished.
  - `integrations` Integrations
    - `salesforce` SalesforceIntegration
      - `object` string
      - `object_id` string

## Response `200`

Successful operation — the IVR callback has been initiated.

- CallbackList
  - `call_id` integer
  - `channel_id` integer

## Other responses

- `401` — Unauthorized — missing or invalid token, or insufficient Calls Write permission.
- `404` — Not found — the specified IVR does not exist.
- `500` — Internal server error.

---

[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)