Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wazzapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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 also send images, videos, documents, and voice messages using public media URLs.
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"
  }'

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!"
  }'
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