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
Getting Started
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.
What Can You Do With the API?
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
Look up chats — including by phone number
Retrieve and update chat details
Add labels and notes to chats
Navigate message history with flexible pagination
Teammates & Workspace
List all teammates in your workspace
View quota and utilization stats for messaging, API calls, and more
Files & Attachments
Upload files and voice messages
List and retrieve workspace files
Usage Limits
Limit | Details |
Monthly API calls | 200,000 per workspace |
Rate limit | 50 requests per minute |
Mass-sending quota | Resets monthly; unused quota does not carry over |
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 — visible in the browser address bar when viewing a chat.
Outbound webhook payloads — included in event data sent to your configured endpoints.
Next Steps
Explore the full endpoint reference, authentication details, and code examples in the documentation: