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 publishes official client libraries for five languages and a growing collection of integrations that connect WhatsApp events to your database, workflow automation tools, and cloud platforms. All SDKs share the same design: a typed client initialized with your base URL and API key, domain-grouped methods that mirror the REST API, built-in webhook signature verification, and automatic detection of deprecation headers.

Core SDKs

All SDKs (except the Zapier integration) live in the titan-api/sdks monorepo.
SDKPackageLanguageInstall
TypeScript@titan-api/sdkTypeScript/JavaScriptnpm install @titan-api/sdk
Gotitan-sdk-goGogo get github.com/titan-api/titan-sdk-go
Pythontitan-sdkPython 3.9+pip install titan-sdk
PHPtitan/sdkPHP 8.1+composer require titan/sdk
C#Titan.Sdk.NET 8+dotnet add package Titan.Sdk

Quick start

Every SDK follows the same pattern: create a client with your base URL and API key, then call domain-grouped methods.
import { TitanClient } from '@titan-api/sdk';

const client = new TitanClient({
  baseUrl: 'https://api.example.com',
  apiKey: 'titan_...',
});

const resp = await client.messages.send('default', {
  chatId: '[email protected]',
  type: 'text',
  text: 'Hello from TypeScript!',
});

Service domains

Every SDK organizes API methods into the same domains. The naming convention follows each language’s idiomatic style.
DomainTypeScriptGoPythonPHP
Sessionsclient.sessionsclient.Sessionsclient.sessions$client->sessions()
Messagesclient.messagesclient.Messagesclient.messages$client->messages()
Contactsclient.contactsclient.Contactsclient.contacts$client->contacts()
Groupsclient.groupsclient.Groupsclient.groups$client->groups()
Channelsclient.channelsclient.Channelsclient.channels$client->channels()
Presenceclient.presenceclient.Presenceclient.presence$client->presence()
Profileclient.profileclient.Profileclient.profile$client->profile()
Labelsclient.labelsclient.Labelsclient.labels$client->labels()
Chatsclient.chatsclient.Chatsclient.chats$client->chats()
Webhooksclient.webhooksclient.Webhooksclient.webhooks$client->webhooks()
Pairingclient.pairingclient.Pairingclient.pairing$client->pairing()
LIDsclient.lidsclient.LIDsclient.lids$client->lids()
Mediaclient.mediaclient.Mediaclient.media$client->media()
Client tokensclient.clientTokensclient.ClientTokensclient.client_tokens$client->clientTokens()

What every SDK provides

Typed client — all request and response shapes are typed. TypeScript uses the @titan-api/types package. Go, Python, PHP, and C# types are auto-generated from the OpenAPI spec. Webhook signature verification — built-in HMAC-SHA256 verification so you can validate incoming webhook payloads without writing your own cryptography. See the individual SDK pages for the verification API in each language. Client token support — every SDK accepts either a server API key (titan_...) or a short-lived client token (titan_ct_...). See Client tokens for details. Deprecation header detection — the SDK automatically reads Deprecation, Sunset, and Titan-SDK-Deprecation response headers and emits a warning once per client lifetime so you know when to upgrade.

SDK pages

TypeScript

@titan-api/sdk on npm. TypeScript and JavaScript with full type inference.

Python

titan-sdk on PyPI. Requires Python 3.9 or later.

Go

titan-sdk-go on GitHub. Idiomatic Go with context support.

PHP

titan/sdk on Packagist. Requires PHP 8.1 or later.

Integrations

DB sync adapters

DB sync adapters turn incoming Titan webhook events into database writes automatically. Each adapter handles signature verification, event deduplication, and mapping webhook payloads to your database schema. Adapters are available for Supabase, Convex, Firebase, Laravel, Cloudflare D1, Vercel Postgres, DynamoDB, Cosmos DB, Cloud SQL, DigitalOcean Postgres, and Neon.

DB sync adapters

Persist WhatsApp events to your database with zero boilerplate.

No-code and low-code

Zapier

Connect WhatsApp to 5,000+ apps. 30 triggers, 63 actions, 25 searches.

n8n

Community node with 13 resources and 30 trigger events.