---
title: "Send DTMF tones during a live call"
method: POST
path: "/channels/{channelId}/events/dtmf"
tags: ["channels"]
---

# Send DTMF tones during a live call

`POST /channels/{channelId}/events/dtmf`

Sends DTMF (Dual-Tone Multi-Frequency) tones on the specified live call channel. DTMF tones are the signals produced by phone keypads (digits 0-9, *, #). Use this to interact with external IVR menus, automated phone systems, or voicemail boxes during a live call.

The `channelId` identifies a specific participant's leg in the call. Use `POST /calls/current` to discover active channel IDs. The DTMF digits to send are specified in the request body.

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

**Monitoring:** **Required.** This is a live call supervisory control. Returns `401 Unauthorized` if Monitoring is OFF on your API key.

## Path parameters

- `channelId` string, required

## Request body

- EventDtmf
  - `dtmf` string — possible value [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, \#, *]

## Response `201`

Successfully processed — the DTMF tones have been sent on the channel.

## Other responses

- `400` — Invalid request body or channel ID format.
- `401` — Unauthorized — missing or invalid token, or Monitoring is not enabled on your API key.
- `404` — Channel not found — no active call channel matches the provided ID.
- `500` — Internal server error.
- `502` — Service temporarily unavailable — please retry later.

---

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