Quickstart

This guide takes you from zero to a sent WhatsApp message.

1. Connect a session

1. Open the Teiwah dashboard.
2. Create a new session and scan the QR code with the WhatsApp account you want to connect.
3. Wait until the session shows as connected.

2. Get your API key

Each session has its own API key. Copy it from the session in the dashboard.

The key identifies the session and authorizes every API call. Keep it secret — treat it like a password.

Note

API keys are issued and managed entirely from the dashboard. A key only works after its session has been connected via QR scan.

3. Send a message

Send a text message with a single request:

curl -X POST https://api.teiwah.cloud/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "972501234567",
    "message": {
      "type": "text",
      "body": "Hello from Teiwah"
    }
  }'

A successful response returns the WhatsApp message id:

{
  "id": "3EB0C767D7A0D9D8F8A1",
  "status": "ok"
}

Next steps

• Authentication — how the session Bearer key works.
• Send a message — all message types.
• Receive webhooks — handle inbound messages.
• API Reference — full interactive reference.