Skip to main content
POST
/
api
/
send
/
media
curl --request POST \
  --url https://app.sentsays.com/api/send/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "+919856784357",
  "media_type": "image",
  "media_url": "https://images.pexels.com/photos/276267/pexels-photo-276267.jpeg?auto=compress&cs=tinysrgb&w=1260&h=750&dpr=2",
  "caption": "Check out our latest smartphone collection! High-quality cameras, long battery life, and sleek design.",
  "file_name": "smartphone_collection_2025"
}
'
{
  "statusCode": 200,
  "data": {
    "success": true,
    "data": {
      "messaging_product": "whatsapp",
      "contacts": [
        {
          "input": "+919856784357",
          "wa_id": "919856784357"
        }
      ],
      "messages": [
        {
          "id": "wamid.HBgMOTE5ODU2Nzg0MzU3FQIAERgSMTI0MEQwN0VCODY2NUMyMjI5AA==",
          "message_status": "accepted"
        }
      ],
      "chat": {
        "id": 78,
        "uuid": "04d28eed-805f-4314-853e-5f415af69a79",
        "organization_id": 13,
        "wam_id": "wamid.HBgMOTE5ODU2Nzg0MzU3FQIAERgSMTI0MEQwN0VCODY2NUMyMjI5AA==",
        "contact_id": 6,
        "user_id": 0,
        "type": "outbound",
        "metadata": "{\"text\":{\"body\":\"hello world\"},\"type\":\"text\"}",
        "media_id": 123,
        "status": "delivered",
        "is_read": 0,
        "created_at": "2025-06-09T10:55:21Z",
        "contact": {
          "id": 6,
          "uuid": "31e68902-3a30-41d2-816c-5e429970b900",
          "organization_id": 13,
          "first_name": "Jennifer",
          "last_name": "Hudson",
          "phone": "+919856784357",
          "email": "[email protected]",
          "full_name": "Jennifer Hudson",
          "formatted_phone_number": "+91 98567 84357",
          "latest_chat_created_at": "2025-06-09T11:00:34Z",
          "avatar": "<string>",
          "address": "{\"street\":\"Althan\",\"city\":\"Surat\",\"state\":\"Gujarat\",\"zip\":\"395017\",\"country\":\"India\"}",
          "metadata": "[]",
          "contact_group_id": 123,
          "is_favorite": 0,
          "ai_assistance_enabled": 0,
          "unread_messages": 0,
          "created_by": 4,
          "created_at": "2025-06-09T10:36:09Z",
          "updated_at": "2025-06-09T10:36:09Z",
          "deleted_at": null
        },
        "media": {
          "id": 6,
          "name": "testFile",
          "path": "https://images.pexels.com/photos/276267/pexels-photo-276267.jpeg",
          "location": "amazon",
          "type": "image/jpeg",
          "size": "517094",
          "created_at": "2025-06-09T11:00:34Z"
        }
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Include your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

Body

application/json
​
phone
string
required

Recipient's WhatsApp phone number in international format (E.164)

Example:

"+919856784357"

​
media_type
enum<string>
required

Type of media being sent

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

"image"

​
media_url
string<uri>
required

Direct URL to the media file (must be publicly accessible)

Example:

"https://images.pexels.com/photos/276267/pexels-photo-276267.jpeg"

​
caption
string
required

Caption text for the media (required for all media types)

Maximum string length: 1024
Example:

"Check out our latest product collection!"

​
file_name
string
required

Custom filename for the media file

Maximum string length: 240
Example:

"product_catalog_2025"

Response

Media message sent successfully

​
statusCode
integer

HTTP status code

Example:

200

​
data
object