Skip to main content
POST
/
api
/
v1
/
Account
/
{auth_id}
/
Call
/
{call_uuid}
/
DTMF
Send DTMF tones
curl --request POST \
  --url https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/DTMF/ \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>' \
  --data '
{
  "digits": "1234"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt

Use this file to discover all available pages before exploring further.

POST https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/DTMF/
This endpoint lets you send DTMF digits on an active call. DTMF (Dual-Tone Multi-Frequency) tones are the sounds generated when pressing keys on a phone keypad. Use this to automate interactions with IVR systems, enter access codes, or control phone systems programmatically.
The call must be in an active state for DTMF digits to be sent successfully. Invalid digits or calls that have ended will result in an error.

​
Path parameters

ParameterTypeRequiredDescription
auth_idstringYesYour Vobiz authentication ID
call_uuidstringYesUnique identifier of the active call

​
Request parameters

FieldTypeRequiredDescription
digitsstringYesThe DTMF digits to send. Valid characters: 0–9, *, #
legstringNoWhich call leg receives the digits. Values: aleg, bleg. Default: aleg
aleg refers to the caller (A-leg); bleg refers to the callee (B-leg). DTMF tones are sent in the order specified in the digits string.

​
Example request

{
  "digits": "1234#",
  "leg": "aleg"
}

​
Response

202 Accepted
{
  "api_id": "uuid-here",
  "message": "digits sent"
}
FieldDescription
api_idUnique identifier for this API request
messageConfirmation that digits were sent successfully
When automating IVR navigation, add appropriate delays between DTMF sends to allow the system time to process each input before the next prompt plays.

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
auth_id
string
required

Your account Auth ID

Example:

"MA_XXXXXX"

​
call_uuid
string
required

Body

application/json
​
digits
string
required
Example:

"1w2W3"

​
leg
enum<string>
default:aleg
Available options:
aleg,
bleg,
both

Response

200

DTMF sent