HomeDocumentationPricing
    Support
    WazzaBeeWazzaBee
    Sign up

    Quick start with the API

    5 min read
    ·
    484 views
    ·
    Updated 10/22/2026

    Quick start with the WazzaBee API

    This short guide will help you send your first message through the API in 5 minutes.

    💡 What you'll need:
    • A WazzaBee account with a connected channel (WhatsApp, Telegram)
    • An API key from the “Connectors → API” section

    Step 1. Get your API key

    1. Log in to your WazzaBee dashboard
    2. Open the Connectors section
    3. Click “Connect” on the API card
    4. Copy the generated API key
    ⚠️ Important: The API key is shown only once. Keep it somewhere safe.

    Step 2. Find your channel ID

    Get the list of connected channels:

    curl -X GET "https://api.wazzabee.com/api-gateway/v1/channels" \
  -H "Authorization: Bearer YOUR_API_KEY"

    Response:

    {
  "success": true,
  "channels": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "WhatsApp Main",
      "type": "whatsapp_qr",
      "status": "active"
    }
  ]
}

    Copy the id of the channel you need. You'll use it to send messages.

    Step 3. Send your first message

    curl -X POST "https://api.wazzabee.com/api-gateway/v1/messages/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "550e8400-e29b-41d4-a716-446655440000",
    "chatId": "77001234567",
    "text": "Hi! This is a test message from the WazzaBee API."
  }'

    Response (202 Accepted):

    {
  "success": true,
  "queued": true,
  "queueId": "queue-uuid",
  "message": "Message queued for sending"
}
    ℹ️ Please note: Messages are sent asynchronously through a queue. Status 202 means the message has been accepted and will be delivered within seconds.

    Step 4. Set up incoming messages (optional)

    To get notified about incoming messages, set up a webhook:

    curl -X PATCH "https://api.wazzabee.com/api-gateway/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhooksUri": "https://your-server.com/webhook/wazzabee",
    "subscriptions": ["messages_incoming"]
  }'

    What's next?

    Detailed documentation for every endpoint is available in the API documentation section: