Skip to main content
POST
/
api
/
call
/
fake
/
:instance
Fake Call
curl --request POST \
  --url https://api.example.com/api/call/fake/:instance \
  --header 'Content-Type: <content-type>' \
  --header 'token: <token>' \
  --data '
{
  "number": "<string>",
  "duration": 123
}
'
Auth: TokenAccount or TokenInstance • Rate-limit: Global (100/min) • Idempotent: no

​
Description

Starts a voice call that rings the recipient’s phone for a few seconds and hangs up on its own, no audio, no media connection. Useful to grab attention, validate a number, or for “ring-and-drop” flows. The duration field controls how many seconds the call rings before the automatic hang-up: default 8 seconds, allowed range 1 to 60.

​
Examples

​
Simple fake call

Uses the default duration (8 seconds). 
curl -X POST "https://ryzeapi.cloud/api/call/fake/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5511999999999"
  }'

​
Ring for a specific duration

duration: 15 makes the call ring for 15 seconds before hanging up. 
curl -X POST "https://ryzeapi.cloud/api/call/fake/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number":   "5511999999999",
    "duration": 15
  }'

​
Success response

200 OK
{
  "success":  true,
  "message":  "Call placed successfully",
  "callId":   "3EB08FCF27E532F1D3D3",
  "number":   "5511999999999",
  "duration": 8
}
The call is ended automatically by the server after duration seconds. There is no audio stream on this call.

​
Path parameters

​
instance
string
required
Instance name (e.g., $Instance_Name).

​
Headers

​
token
string
required
TokenAccount or TokenInstance.
​
Content-Type
string
required
application/json

​
Request body

​
number
string
required
Destination: phone (5511999999999) or JID (@s.whatsapp.net).
​
duration
int
default:"8"
Seconds the call rings before hanging up automatically. Allowed range: 1 to 60. Omitted or 0 uses the default 8.

​
Errors

HTTPMessage
400Instance name is required
400Invalid request body: <detail>
400Number is required
400Duration must be between 1 and 60 seconds
404instance not found
500<failure reason>
Error envelope: 
{
  "success": false,
  "error": { "message": "Duration must be between 1 and 60 seconds" }
}