Skip to content
Teiwah Docs

Teiwah API

WhatsApp automation for builders. Receive messages via webhooks, send replies via a tiny REST API.
Quickstart API Reference

How Teiwah works

Section titled “How Teiwah works”

Teiwah connects a WhatsApp number to your automation. The model is intentionally small:

flowchart LR
  WA[Incoming WhatsApp message] --> H[Teiwah webhook]
  H --> A[AI / n8n / your backend]
  A --> S[POST /messages]
  S --> WA2[WhatsApp reply]

Send messages

One endpoint, POST /messages, for text, image, voice notes, audio, video, documents, and location.

Receive webhooks

Inbound WhatsApp events are delivered to your webhook URL with an explicit message type for easy routing.

Session API keys

Each connected WhatsApp session has its own Bearer key, issued by the Teiwah dashboard.

Media by URL

Media is referenced by URL. Download inbound media on demand; send outbound media by URL or base64.

Get started

Section titled “Get started”
  1. Create a session and connect WhatsApp in the Teiwah dashboard.
  2. Copy the session API key.
  3. Follow the Quickstart to send your first message.