Skip to main content
POST
Request Call Permission
Send a customer WhatsApp’s Allow calls button. Their answer reaches your webhook as a call event with kind: "call_permission", and the request shows in their chat in FlowIQ. This message is allowed only within 24 hours of the customer last writing to you; outside that window, send an approved template that has a call permission request with Send Template.

Basic Usage


Body Parameters


Response

Success (200)


Errors

Authorizations

Authorization
string
header
required

Your FlowIQ organisation API key (Settings → API Keys), sent as a bearer token. Format: Bearer fiq_YOUR_API_KEY

Body

application/json
to
string

The customer's WhatsApp number (or send contact_id)

Example:

"27820000000"

contact_id
string<uuid>
body
string

Optional text above the button, e.g. why you want to call

Maximum string length: 1024
Example:

"We'd like to call you about your order."

Response

Success

organization_id
string<uuid>
success
boolean
message_id
string
contact_id
string<uuid>
whatsapp_id
string