> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TimelinesAI

> TimelinesAI enables teams to manage and automate WhatsApp communications, integrating with various CRMs and tools to streamline workflows.

![TimelinesAI logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/timelinesai.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=6759da0e91b42afb40cbd0a9efbd7bd1)

* **Category:** communication
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 13
* **Triggers:** 1
* **Slug:** `TIMELINESAI`
* **Version:** 20261101\_00

## Tools

> [accordion] Delete File
>
> **Slug:** `TIMELINESAI_DELETE_FILE`
>
> Tool to delete an uploaded file by its UID. Use after confirming the file is no longer needed.
>
> #### Input Parameters
>
> **file\_uid** `string` *required*
>
> Unique identifier of the file to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Webhook
>
> **Slug:** `TIMELINESAI_DELETE_WEBHOOK`
>
> Tool to delete a webhook subscription by its ID. Use when you need to remove an existing webhook after confirming the webhook ID. Example: "Delete the webhook with ID '9f6a8c3d-56b7-4a1e-8f2e-abcdef123456'."
>
> #### Input Parameters
>
> **webhook\_id** `string` *required*
>
> Unique identifier of the webhook subscription to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Chat Messages
>
> **Slug:** `TIMELINESAI_GET_CHAT_MESSAGES`
>
> Tool to get messages from a specific chat in TimelinesAI. Use when you need to retrieve message history or recent messages from a chat. Example: "Get the last 20 messages from chat 'chat\_123abc'."
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of messages to return
>
> **offset** `integer`
>
> Number of messages to skip before returning results
>
> **chat\_id** `string` *required*
>
> Unique identifier of the chat to retrieve messages from
>
> **after\_message\_id** `string`
>
> Get messages after this message ID (for pagination)
>
> **before\_message\_id** `string`
>
> Get messages before this message ID (for pagination)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Chats
>
> **Slug:** `TIMELINESAI_GET_CHATS`
>
> List or search chats with optional filters and pagination. The returned total is the number of chats in the returned page, not a count across all matching pages.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of chats to return
>
> **types** `array`
>
> List of chat types to include (e.g., \['group', 'direct'])
>
> **offset** `integer`
>
> Number of chats to skip before returning results
>
> **search** `string`
>
> Search term to filter chats by name or content
>
> **is\_muted** `boolean`
>
> If true, only chats that are muted
>
> **label\_id** `string`
>
> Filter chats by the specified label ID
>
> **has\_label** `boolean`
>
> If true, only chats that have at least one label
>
> **is\_unread** `boolean`
>
> If true, only chats with unread messages are returned
>
> **person\_id** `string`
>
> Filter chats by the associated person ID
>
> **sort\_field** `string`
>
> Field by which to sort results (e.g., 'createdAt')
>
> **assignee\_id** `string`
>
> Filter chats by the specified assignee ID
>
> **is\_archived** `boolean`
>
> If true, only archived chats will be returned
>
> **is\_assigned** `boolean`
>
> If true, only chats that have been assigned
>
> **is\_followed** `boolean`
>
> If true, only chats followed by the current user
>
> **created\_since** `string`
>
> ISO 8601 date string; return chats created after this timestamp
>
> **has\_open\_task** `boolean`
>
> If true, only chats with open tasks
>
> **integration\_id** `string`
>
> Filter chats by the specified integration ID
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Sort order: 'asc' (ascending) or 'desc' (descending)
>
> **team\_member\_id** `string`
>
> Filter chats involving the specified team member ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get File Details
>
> **Slug:** `TIMELINESAI_GET_FILE_DETAILS`
>
> Tool to retrieve metadata and temporary download URL for an uploaded file. Use after uploading a file or when needing its URL.
>
> #### Input Parameters
>
> **file\_uid** `string` *required*
>
> Unique identifier of the file to retrieve details for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Webhook
>
> **Slug:** `TIMELINESAI_GET_WEBHOOK`
>
> Retrieves detailed information about a specific webhook subscription by its ID. Use this action to: - Check webhook configuration (URL, event type, enabled status) - Monitor webhook health (error counter) - Verify webhook existence before updating or deleting Prerequisites: You must have a valid webhook ID. Use the Get Webhooks action to list all available webhooks first.
>
> #### Input Parameters
>
> **webhook\_id** `string` *required*
>
> The unique webhook ID (numeric string). Use Get Webhooks action to list all available webhook IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Webhooks
>
> **Slug:** `TIMELINESAI_GET_WEBHOOKS`
>
> Retrieves all webhook subscriptions configured for the workspace. Webhooks notify external systems about events (e.g., 'message:new', 'chat:new') in real-time. Use this to view existing webhook configurations, check their status, or retrieve webhook IDs for updates/deletion. Supports optional pagination via limit and offset parameters.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of webhooks to return per page
>
> **offset** `integer`
>
> Number of webhooks to skip before returning results
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get WhatsApp Accounts
>
> **Slug:** `TIMELINESAI_GET_WHATSAPP_ACCOUNTS`
>
> Tool to list all WhatsApp accounts connected to the workspace. Use after configuring WhatsApp integration to verify accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Uploaded Files
>
> **Slug:** `TIMELINESAI_LIST_UPLOADED_FILES`
>
> Tool to list files uploaded in your TimelinesAI workspace. Use when you need to retrieve all uploaded files.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send WhatsApp Message to Number
>
> **Slug:** `TIMELINESAI_POST_MESSAGE`
>
> Send a WhatsApp text message to a phone number via TimelinesAI using a connected WhatsApp account as the sender. Messages may be queued and sent with a delay.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> Message text to send. Note: text length is limited by the WhatsApp platform (currently 65,534 characters).
>
> **phone** `string` *required*
>
> Recipient's phone number in international format with a leading '+' and country code.
>
> **whatsapp\_account\_phone** `string` *required*
>
> Your sender WhatsApp number in international format with a leading '+' and country code. This must be a WhatsApp account that is already connected to your TimelinesAI workspace.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Webhook Subscription
>
> **Slug:** `TIMELINESAI_POST_WEBHOOK`
>
> Create a webhook subscription for an event and callback URL. If the same event and URL already match a workspace subscription, the existing subscription is returned and may be re-enabled or restored.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The HTTP endpoint URL that will receive webhook payloads.
>
> **secret** `string`
>
> Optional secret used to sign webhook payloads (HMAC).
>
> **event\_type** `string` *required*
>
> Event type to subscribe to. Valid values: 'message:new', 'message:sent:new', 'message:received:new', 'whatsapp:account:connected', 'whatsapp:account:disconnected', 'whatsapp:account:suspended', 'whatsapp:account:resumed', 'chat:new', 'chat:incoming:new', 'chat:outgoing:new', 'chat:responsible:assigned', 'chat:responsible:unassigned'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Webhook
>
> **Slug:** `TIMELINESAI_PUT_WEBHOOK`
>
> Update an existing webhook subscription by ID, supplying its URL and event type and optionally enabling or disabling it.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> The URL endpoint that will receive webhook event notifications
>
> **enabled** `boolean`
>
> Whether the webhook should be active. If omitted, current state is preserved
>
> **event\_type** `string` *required*
>
> Single event type to subscribe to. Common types: 'message:new', 'chat:new', 'message:received:new', 'message:sent:new', 'chat:incoming:new', 'chat:outgoing:new', 'chat:responsible:assigned', 'chat:responsible:unassigned', 'whatsapp:account:connected', 'whatsapp:account:disconnected'
>
> **webhook\_id** `string` *required*
>
> Unique identifier of the webhook subscription to update (numeric ID as string)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Message to Chat
>
> **Slug:** `TIMELINESAI_SEND_MESSAGE`
>
> Send a WhatsApp message to an existing chat in TimelinesAI. Use this action when you have a chat ID from the Get Chats action and want to send a message to that conversation. For sending messages to new phone numbers (not existing chats), use the 'Send WhatsApp Message to Number' action instead. Example: "Send message 'Hello world' to chat with ID 'chat\_123abc'."
>
> #### Input Parameters
>
> **chat\_id** `string` *required*
>
> Unique identifier of the chat to send the message to. Obtain this from the Get Chats action.
>
> **message** `string` *required*
>
> The text message to send. Maximum length: 65,534 characters (WhatsApp platform limit).
>
> **message\_type** `string`
>
> Type of message to send. Common values: 'text' for text messages, 'media' for media messages. Defaults to 'text'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

## Triggers

> [accordion] New WhatsApp Message Received
>
> **Slug:** `TIMELINESAI_NEW_MESSAGE_RECEIVED`
>
> **Type:** poll
>
> Polling trigger that monitors for new messages received in TimelinesAI WhatsApp chats.
>
> #### Configuration
>
> **chat\_id** `string`
>
> Filter messages from a specific chat ID. If not provided, all chats will be monitored
>
> **interval** `number`
>
> Periodic Interval to Check for Updates & Send a Trigger in Minutes
>
> **is\_unread** `boolean`
>
> If true, only unread messages will be included
>
> **limit** `integer`
>
> Maximum number of messages to fetch per polling cycle
>
> #### Payload
>
> **chat\_id** `string` *required*
>
> ID of the chat the message belongs to
>
> **event\_type** `string`
>
> Type of event that triggered
>
> **message\_id** `string` *required*
>
> Unique identifier of the message
>
> **message\_type** `string`
>
> Type of message (text, media, etc.)
>
> **sender** `object`
>
> Details of the message sender
>
> **text** `string`
>
> Content of the message
>
> **timestamp** `string` *required*
>
> ISO-8601 timestamp when message was sent
