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 | 200,000 per workspace |
Rate limit | 50 requests per minute |
Mass-sending quota | 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:
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.
