Skip to main content
Use POST /v1/whatsapp/messages/image for receipts, screenshots, and product photos. Point at a publicly reachable media_url; WhatsApp fetches it at send time, so it must be reachable then and serve the correct Content-Type. Needs an open 24-hour window.

​
Endpoint

POST https://karibu.briq.tz/v1/whatsapp/messages/image
Headers: X-API-Key (required), Content-Type: application/json.

​
Fields

FieldTypeRequiredNotes
media_urlstringone sourcePublic HTTPS URL to the image.
file_idstringone sourceUploaded media id (first-party). Use media_url for external integrations.
captionstringnoOptional, up to 1024 characters.
to + sender—targetCustomer number (E.164) and which of your numbers to send from. sender is optional when you have one active number.
conversation_iduuidaltAlternative to to + sender: an existing thread to reply in.

​
Constraints

FormatsJPEG (image/jpeg), PNG (image/png)
Max size5 MB
WhatsApp may re-encode images. A 131052 error means it could not download your media_url (not public, wrong Content-Type, or expired).

​
Example

cURL
curl -X POST "https://karibu.briq.tz/v1/whatsapp/messages/image" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "to": "255712345678", "media_url": "https://example.com/receipt.jpg", "caption": "Your receipt" }'
Returns 202 { message_id, status: "pending" }. Then track delivery. Build and send a live request from the Send an image reference page.