Skip to main content
POST
Send Image

Basic Usage


Request Body

Supported formats: JPEG, PNG. The image is automatically downloaded, uploaded to FlowIQ storage with a 1-year signed URL, then delivered via Meta.

Response

Success (200)

Error: Missing Required Field (400)


Integration Example


Media URLs

Ensure the image URL is publicly accessible. The API needs to download the file before uploading to Meta.

Authorizations

Authorization
string
header
required

Bearer token for authentication. Format: Bearer YOUR_BEARER_TOKEN

Body

application/json
phone_number
string
required

Recipient phone number with country code

Example:

"+27123456789"

message_type
enum<string>
required

Must be "image"

Available options:
image
Example:

"image"

media_url
string
required

Publicly accessible URL to the image file

Example:

"https://example.com/product.jpg"

caption
string

Optional caption for the image

Example:

"Check out this image!"

context_message_id
string

WhatsApp message ID to reply to

Example:

"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."

Response

Message sent successfully

success
boolean
Example:

true

message
string
Example:

"Message sent successfully"

data
object