TimelinesAI API
The TimelinesAI API enables you to programmatically manage WhatsApp communications for your business. Build integrations, automate workflows, and connect WhatsApp to your existing systems.Quickstart
Get up and running in 5 minutes
Authentication
Set up your API token
Send Messages
Learn how to send WhatsApp messages
Webhooks
Receive real-time notifications
Our APIs
TimelinesAI provides two complementary APIs and their webhook systems, each designed for different audiences and use cases.Public API
The Public API is your primary interface for managing WhatsApp communications within a single workspace. Use it to send and receive messages, manage chats, upload files, organize conversations with labels, and subscribe to real-time webhook events. Best for: Businesses integrating WhatsApp into their own workflows — CRMs, support systems, marketing tools, and custom applications.Public API Reference
Explore all messaging and chat management endpoints
PublicAPI Webhooks
Real-time events for messages, chats, and account status
Partner API
The Partner API is designed for platform integrators, resellers, and SaaS providers who manage multiple TimelinesAI workspaces on behalf of their customers. It lets you automate workspace provisioning, user management, WhatsApp onboarding, and API token lifecycle. Best for: Partners building white-label solutions, managed services, or multi-tenant platforms on top of TimelinesAI.Partner API Reference
Workspace, user, and account management endpoints
PartnerAPI Webhooks
Quota alerts, account events, and token change notifications
What you can do
Send & Receive Messages
Send & Receive Messages
Send text messages, images, documents, and voice notes to any WhatsApp number. Retrieve message history and track delivery status from queued through read.
Manage Chats
Manage Chats
List, filter, and organize your WhatsApp conversations. Assign chats to team members, add labels, manage chat status, and add internal notes.
Handle Attachments
Handle Attachments
Upload files from URLs or directly. Send images, PDFs, audio, and video as WhatsApp message attachments.
Real-time Webhooks
Real-time Webhooks
Get instant notifications when messages arrive, are sent, chats are created, or account statuses change. Partner webhooks cover quota alerts and workspace-level events.
Manage Workspaces (Partner)
Manage Workspaces (Partner)
Provision and configure customer workspaces, add users, generate QR codes for WhatsApp onboarding, and manage API tokens programmatically.
Monitor Usage & Quotas
Monitor Usage & Quotas
Track messaging quotas, API call limits, and seat utilization. Partner webhooks alert you when workspaces approach their limits.
Key concepts
| Concept | Description |
|---|---|
| Workspace | Your TimelinesAI account containing all chats, messages, and connected WhatsApp accounts |
| Chat | A conversation thread with a contact or group |
| WID | WhatsApp ID format: phonenumber@s.whatsapp.net (e.g., 14155551234@s.whatsapp.net) |
| JID | Jabber ID — used for groups: groupid@g.us |
| Message UID | Unique identifier for each message (UUID format) |
Rate limits & credits
Messages sent via API consume credits from your messaging quota:| Action | Credits |
|---|---|
| Text message | 1 |
| Message with attachment | 2 |
| Failed message | Refunded |