Send WhatsApp Image Messages

API Endpoint

Use the following endpoint to send an image message:

POST https://public.doubletick.io/whatsapp/message/image

Request Headers

{
  "Authorization": "YOUR_API_KEY",
  "Content-Type": "application/json"
}

Request Body Parameters

{
  "to": "customer_number",
  "from": "sender_number",
  "messageId": "uuid-v4",
  "content": {
    "mediaUrl": "https://your-image-url.com/image.jpg",
    "caption": "Sample Image"
  }
}

Parameters

• to (string, required): Customer’s phone number in international format.
• from (string, optional): Your registered sender phone number in international format.
• messageId (string, optional):
  • Message ID (UUID v4) to be used for the message.
  • If not provided, a random UUID v4 will be generated automatically.
  • Length to be exact 36 characters.
• content (object, required)
  • mediaUrl (string, required):
    • URL of the image file to be sent.
    • Length to be in between 1 to 2048 characters.
  • caption (string, optional):
    • Caption of the image file to be sent.
    • Length to be in between 1 to 3000 characters.

Responses

Success Response (201)

{
  "status": "SENT",
  "recipient": "customer_number",
  "messageId": "unique_message_id"
}

Bad Request (400)

{
  "message": "error_message",
  "error": "Bad Request",
  "statusCode": 400
}

Unauthorized (401)

{
  "message": "Invalid public api key",
  "error": "Unauthorized",
  "statusCode": 401
}

Unprocessable Entity (422)

{
  "message": "invalid file type for audio: text/html; charset=utf-8",
  "error": "Unprocessable Entity",
  "statusCode": 422
}

Best Practices

• Ensure the image file is in a supported format (JPG, PNG, WEBP).
• The media URL must be publicly accessible or hosted on a compatible server.
• If you don’t have a shareable media URL, upload your media to our cloud and use the generated URL to send it.
• Maintain an optimal file size for faster message delivery.