Skip to main content
POST
Send a file

Authorizations

Authorization
string
header
required

Your API key, e.g. gr_live_…

Headers

Idempotency-Key
string
required

Your own unique id for this request (at most 255 characters). The same id and body within 24 hours answers the first answer again — never a second send or charge.

Maximum string length: 255

Body

application/json
to
string
required

The person's WhatsApp number with its country code, e.g. +9198250*****.

type
enum<string>
required
Available options:
image,
video,
audio,
document
url
string
required

An https link to the file.

reference
string

Your own reference for this message (at most 512 characters). It comes back on the message and its webhooks.

Maximum string length: 512
caption
string

A caption.

Maximum string length: 1024
filename
string

A document's file name.

Response

Accepted for sending.

id
string
status
string
to
string
country
string
category
string | null
price
string | null
reference
string | null