Skip to main content
POST
/
api
/
send
curl --request POST \
  --url https://app.sentsays.com/api/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "phone": "+919856784357",
  "message": "Hello! Welcome to our service. How can we help you today?"
}'
{
  "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": "jennifer@gmail.com",
          "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"

​
message
string
required

The text message content to send

Required string length: 1 - 4096
Example:

"Hello! How can we help you today?"

​
header
string

Optional header text displayed above the message

Maximum length: 60
Example:

"Customer Support"

​
footer
string

Optional footer text displayed below the message

Maximum length: 60
Example:

"SentSays Team"

​
buttons
object[]

Interactive buttons for quick replies (maximum 3 buttons)

Maximum length: 3

Response

Message sent successfully

​
statusCode
integer

HTTP status code

Example:

200

​
data
object
⌘I