Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.usetitan.app/llms.txt

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

Titan is a WhatsApp Business API platform that lets you connect any WhatsApp number to your application without requiring an official WhatsApp Business API account. You use Titan’s REST API to create sessions, pair phone numbers, send messages, and receive real-time webhook events — everything WhatsApp supports, you can automate through Titan.

What you can build

Messaging

Send text, images, video, audio, documents, polls, locations, contacts, stickers, and voice notes. Edit and delete sent messages, react with emoji, and mark messages as read.

Sessions and pairing

Connect WhatsApp numbers via QR code scan or 8-digit phone pairing code. Sessions auto-reconnect after drops, and each session can have its own proxy and configuration.

Webhooks

Receive real-time events for incoming messages, delivery acknowledgments, session status changes, group updates, presence, calls, and 30 event types in total.

Groups and channels

Create and manage groups with up to 256 participants. Follow, mute, and publish to WhatsApp Channels (newsletters).

SDKs

Official clients for TypeScript, Go, Python, PHP, and C#. Every SDK includes typed requests and responses, webhook signature verification, and deprecation detection.

MCP server

Give AI agents full autonomous WhatsApp access via 76 structured tools, 3 resources, and 3 prompt templates. Compatible with Claude Desktop, Cursor, and custom MCP clients.

Embedded connect widget

Drop a React component, iframe, or script tag into your UI so your users can pair their own WhatsApp numbers in under 60 seconds — no backend required.

Self-hosting

Deploy Titan on your own infrastructure using Docker Compose, a Helm chart, or AWS CloudFormation. You own the data and control the upgrade schedule.

Editions

Titan ships in two editions. The right choice depends on how much infrastructure you want to manage.
SaaSSelf-hosted
DeploymentManaged cloud, no setupYour own servers or cloud account
AuthenticationAPI keysAPI keys + master key for admin routes
UpdatesAutomaticManual, on your schedule
Multi-tenancyYesNo — single tenant per instance
MCP serverIncludedAvailable via Docker image
Admin APINot applicableFull admin endpoints for key and settings management
If you are on the self-hosted edition, see Self-Hosting for deployment options. The API surface is the same for both editions unless a page notes otherwise.

How Titan works

Every integration follows the same pattern regardless of which language or SDK you use.
1

Create an API key

Generate a scoped API key from your account dashboard or via POST /api/account/keys. Pass the key as Authorization: Bearer titan_... on every request.
2

Create and start a session

Each WhatsApp number you want to connect needs its own named session. Call POST /api/sessions to create one, then POST /api/sessions/{session}/start to start it.
3

Pair your WhatsApp number

Retrieve a QR code from GET /api/sessions/{session}/pairing/qr and scan it from WhatsApp, or request a pairing code and enter it without a camera. Once paired, the session status moves to CONNECTED.
4

Send messages and receive events

Call POST /api/messages/send with the session name, recipient chat ID, and message type. Register a webhook via POST /api/webhooks to receive incoming messages, delivery receipts, and all other events in real time.

Next steps

Quickstart

Follow a step-by-step guide from zero to sending your first WhatsApp message.

Authentication

Learn how API keys work, what scopes are available, and how to rotate keys safely.