Skip to main content
TimelinesAI logo
  • Category: communication
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 13
  • Triggers: 1
  • Slug: TIMELINESAI
  • Version: 20261101_00

Tools

Slug: TIMELINESAI_DELETE_FILETool to delete an uploaded file by its UID. Use after confirming the file is no longer needed.

Input Parameters

string
required
Unique identifier of the file to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_DELETE_WEBHOOKTool 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

string
required
Unique identifier of the webhook subscription to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_GET_CHAT_MESSAGESTool 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

integer
Maximum number of messages to return
integer
Number of messages to skip before returning results
string
required
Unique identifier of the chat to retrieve messages from
string
Get messages after this message ID (for pagination)
string
Get messages before this message ID (for pagination)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_GET_CHATSList 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

integer
Maximum number of chats to return
array
List of chat types to include (e.g., [‘group’, ‘direct’])
integer
Number of chats to skip before returning results
Search term to filter chats by name or content
boolean
If true, only chats that are muted
string
Filter chats by the specified label ID
boolean
If true, only chats that have at least one label
boolean
If true, only chats with unread messages are returned
string
Filter chats by the associated person ID
string
Field by which to sort results (e.g., ‘createdAt’)
string
Filter chats by the specified assignee ID
boolean
If true, only archived chats will be returned
boolean
If true, only chats that have been assigned
boolean
If true, only chats followed by the current user
string
ISO 8601 date string; return chats created after this timestamp
boolean
If true, only chats with open tasks
string
Filter chats by the specified integration ID
string ("asc" | "desc")
Sort order: ‘asc’ (ascending) or ‘desc’ (descending)
string
Filter chats involving the specified team member ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_GET_FILE_DETAILSTool to retrieve metadata and temporary download URL for an uploaded file. Use after uploading a file or when needing its URL.

Input Parameters

string
required
Unique identifier of the file to retrieve details for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_GET_WEBHOOKRetrieves 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

string
required
The unique webhook ID (numeric string). Use Get Webhooks action to list all available webhook IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_GET_WEBHOOKSRetrieves 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

integer
Maximum number of webhooks to return per page
integer
Number of webhooks to skip before returning results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_GET_WHATSAPP_ACCOUNTSTool to list all WhatsApp accounts connected to the workspace. Use after configuring WhatsApp integration to verify accounts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_LIST_UPLOADED_FILESTool to list files uploaded in your TimelinesAI workspace. Use when you need to retrieve all uploaded files.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_POST_MESSAGESend 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

string
required
Message text to send. Note: text length is limited by the WhatsApp platform (currently 65,534 characters).
string
required
Recipient’s phone number in international format with a leading ’+’ and country code.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_POST_WEBHOOKCreate 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

string
required
The HTTP endpoint URL that will receive webhook payloads.
string
Optional secret used to sign webhook payloads (HMAC).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_PUT_WEBHOOKUpdate an existing webhook subscription by ID, supplying its URL and event type and optionally enabling or disabling it.

Input Parameters

string
required
The URL endpoint that will receive webhook event notifications
boolean
Whether the webhook should be active. If omitted, current state is preserved
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’
string
required
Unique identifier of the webhook subscription to update (numeric ID as string)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TIMELINESAI_SEND_MESSAGESend 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

string
required
Unique identifier of the chat to send the message to. Obtain this from the Get Chats action.
string
required
The text message to send. Maximum length: 65,534 characters (WhatsApp platform limit).
string
Type of message to send. Common values: ‘text’ for text messages, ‘media’ for media messages. Defaults to ‘text’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: TIMELINESAI_NEW_MESSAGE_RECEIVEDType: pollPolling trigger that monitors for new messages received in TimelinesAI WhatsApp chats.

Configuration

string
Filter messages from a specific chat ID. If not provided, all chats will be monitored
number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
boolean
If true, only unread messages will be included
integer
Maximum number of messages to fetch per polling cycle

Payload

string
required
ID of the chat the message belongs to
string
Type of event that triggered
string
required
Unique identifier of the message
string
Type of message (text, media, etc.)
object
Details of the message sender
string
Content of the message
string
required
ISO-8601 timestamp when message was sent