Overview
The TimelinesAI Public API lets you connect external systems such as CRMs, helpdesks, and internal tools to your TimelinesAI workspace.
Automate WhatsApp messaging, manage chats, sync data, and build custom workflows triggered by events in your existing stack.
đ Full API reference: TimelinesAI API Documentation
Generate Your API Token
To authenticate with the API, generate a unique API token from your TimelinesAI workspace settings. This token authorizes all requests made on behalf of your workspace.
Tokens can be regenerated at any time, doing so immediately disables the previous token.
Keep your token secure. If you suspect it has been compromised, regenerate it right away.
Try It Out
You can test API requests directly in the interactive playground available in the API documentation. This lets you experiment with request formats and see real responses before writing any integration code.
Note: API calls made through the playground count toward your workspace usage and credit limits.
Usage Limits
Limit | Details |
Monthly API calls | Depends on your subscription plan. The exact value for your workspace and current usage are shown on the Integrations â Public API page in your account. Additional API calls can be purchased â see API calls limit on TimelinesAI. |
Rate limit | 50 requests per minute |
Messaging credits (mass-sending quota) | Every message sent through the API, including a normal one-to-one reply sent from your own app, uses 1 messaging credit as well as 1 API call. Credits come from your plan's monthly automation and mass messaging credits (on the current plans: Starter 50, Pro 500, Enterprise 2,000 per seat a month, pooled for the workspace). Only messages your team types one by one in the TimelinesAI inbox are unlimited. Webhooks use neither credits nor API calls. See Mass sending quota overview. Resets monthly; unused quota does not carry over |
Note: Failed messages restore their associated quota units.
Monitoring & Logs:
You can download API log reports containing your latest 1,000 requests to analyze usage patterns and troubleshoot issues.
Finding Your Chat ID
Chat IDs can be found in two places:
Workspace URL that is visible in the browser address bar when viewing a chat.
Outbound webhook payloads are included in event data sent to your configured endpoints.
Explore the full endpoint reference, authentication details, and code examples in the documentation:
WABA (WhatsApp Business API) numbers
WABA numbers use a separate set of endpoints and webhooks. The regular /chats, /messages and /whatsapp_accounts endpoints return only QR-connected numbers. For WABA chats they respond "This is a WABA chat. Use the /waba/chats and /waba/messages endpoints instead."
List your WABA numbers and their IDs: GET /waba/accounts. The id returned is the waba_account_id used by the other calls. It is not Meta's Phone Number ID.
Send a text or a template: POST /waba/messages with waba_account_id and phone, plus either text or a template object (`name`, `language`, e.g. `en_US`, and optional `variables`). Outside the 24-hour window only templates can be sent.
List templates: GET /waba/templates.
Webhooks: subscribe to waba:* events (e.g. waba:message:received, waba:message:failed) with POST /webhooks.
TimelinesAI doesn't share your Meta access token or system-user credentials. Use your TimelinesAI API token with the WABA endpoints.
Make, Zapier, n8n: there is no dedicated WABA or template module yet. Use an HTTP request step calling the endpoints above.
FAQs: What can you do with the API?
Message Management
Message Management
Retrieve message details and metadata
Access message delivery status and history
Send replies and new messages programmatically
Read and set message reactions
Chat Operations
Chat Operations
Look up chats by phone number
Retrieve and update chat details
Add labels and notes to chats
Navigate message history with flexible pagination
Teammates & Workspace
Teammates & Workspace
List all teammates in your workspace
View quota and utilization stats for messaging, API calls, and more.
Files & Attachments
Files & Attachments
Upload files and voice messages
List and retrieve workspace files.