Sending Messages

The WazzAPI API supports direct sends, scheduled sends, retries, media messages, and interactive message types.

Text Messages

Use the /api/v1/messages/send endpoint for standard text messages.

curl -X POST https://api.wazzapi.com/api/v1/messages/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "6281234567890",
    "content": "Hello, world!",
    "message_type": "text",
    "whatsapp_account_id": "00000000-0000-0000-0000-000000000000"
  }'

Media Messages

You can send images, videos, documents, and voice messages with either a public media_url or inline media_base64. When both are provided, media_base64 is used.

curl -X POST https://api.wazzapi.com/api/v1/messages/send/image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "6281234567890",
    "media_url": "https://example.com/image.png",
    "caption": "Product preview",
    "whatsapp_account_id": "00000000-0000-0000-0000-000000000000"
  }'

curl -X POST https://api.wazzapi.com/api/v1/messages/send/image \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "6281234567890",
    "media_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "caption": "Product preview",
    "whatsapp_account_id": "00000000-0000-0000-0000-000000000000"
  }'

curl -X POST https://api.wazzapi.com/api/v1/messages/send/document \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "6281234567890",
    "content": "Invoice attached",
    "media_url": "https://example.com/file.pdf",
    "caption": "April invoice",
    "message_type": "document",
    "whatsapp_account_id": "00000000-0000-0000-0000-000000000000"
  }'

curl -X POST https://api.wazzapi.com/api/v1/messages/send/document \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "6281234567890",
    "content": "Invoice attached",
    "media_base64": "JVBERi0xLjQKJcfs...",
    "filename": "invoice.pdf",
    "mimetype": "application/pdf",
    "caption": "April invoice",
    "whatsapp_account_id": "00000000-0000-0000-0000-000000000000"
  }'

Inline media fields

Field	Description
`media_base64`	Raw base64 or a complete `data:...;base64,...` URI. Takes precedence over `media_url`.
`filename`	Optional filename override. Required for document sends that use `media_base64`.
`mimetype`	MIME hint such as `image/png` or `application/pdf`. Required when `media_base64` is raw base64 and no filename is supplied.

Inline media is stored temporarily before delivery, so retries and scheduled messages can still work while the media object is retained. Request size limits are enforced by the API gateway/proxy.

Location Messages

Use location messages to share a pin with latitude and longitude.

curl -X POST https://api.wazzapi.com/api/v1/messages/send/location \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "6281234567890",
    "message_type": "location",
    "latitude": -6.208763,
    "longitude": 106.845599,
    "location_title": "Jakarta HQ",
    "location_address": "Central Jakarta",
    "whatsapp_account_id": "00000000-0000-0000-0000-000000000000"
  }'

WhatsApp Group Messages

Send messages directly to WhatsApp groups using the groups API. The API automatically looks up the group name from the backend and stores it with the message record.

Text

 curl -X POST https://api.wazzapi.com/api/v1/groups/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_name": "my-session",
    "group_jid": "[email protected]",
    "text": "Hello everyone!"
  }'

Image

 curl -X POST https://api.wazzapi.com/api/v1/groups/send/media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_name": "my-session",
    "group_jid": "[email protected]",
    "media_url": "https://example.com/photo.jpg",
    "media_type": "image",
    "caption": "Check this out!"
  }'

Image Base64

 curl -X POST https://api.wazzapi.com/api/v1/groups/send/media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_name": "my-session",
    "group_jid": "[email protected]",
    "media_type": "image",
    "media_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
    "caption": "Check this out!"
  }'

Supported types for groups: text, image, video, voice, document. Templates and interactive messages are not supported for groups.

Other supported message types

The API also supports:

voice messages
video messages
contact-card messages
interactive button messages
interactive list messages

Scheduling, retries, and status

In addition, the API supports:

scheduled_for on send requests for future delivery
retrying failed messages
cancelling scheduled messages
lookup by provider ID and message statistics

​Sending Messages

​Text Messages

​Media Messages

​Inline media fields

​Location Messages

​WhatsApp Group Messages

​Other supported message types

​Scheduling, retries, and status