Skip to main content
POST
/
send
/
media
Dispatch Rich Media Attachments
curl --request POST \
  --url https://app.wachat.net/api/v1/send/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instanceName": "<string>",
  "number": "<string>",
  "type": "image",
  "mediaUrl": "https://cdn.pixabay.com/photo/2022/09/23/09/13/promotion-7474039_1280.png",
  "message": "Check out this month exciting promotions!",
  "fileName": "promotion-7474039_1280.png",
  "mimetype": "image/png",
  "delay": 123
}
'

Authorizations

​
Authorization
string
header
required

Authenticate your integration payloads by injecting your premium secure Wachat Account API Private Secret Key inside standard Authorization Bearer header vectors.

Body

application/json
​
instanceName
string
required

Name of your connected WhatsApp session profile.

​
number
string
required

Target phone number with international country code routing.

​
type
enum<string>
required

Supported structural file classification standard.

Available options:
image,
video,
document,
audio
Example:

"image"

​
mediaUrl
string<uri>
required

The direct fully qualified URL endpoint hosting your media asset.

Example:

"https://cdn.pixabay.com/photo/2022/09/23/09/13/promotion-7474039_1280.png"

​
message
string

Contextual rich text descriptive caption elements accompanied with media assets (ignored for audio payloads).

Example:

"Check out this month exciting promotions!"

​
fileName
string

Explicit file attachment naming convention overlay. Strongly recommended for structural documents.

Example:

"promotion-7474039_1280.png"

​
mimetype
string

Explicit custom Multipurpose Internet Mail Extensions header format definition overlay.

Example:

"image/png"

​
delay
integer

Custom simulated typing delay parameter in milliseconds. If left empty, it runs an organic 3-5 seconds random engine delay.

Response

200

Media payload processed and dispatched through the cloud instance infrastructure.