Learn how to read an item's Email & Activities timeline using the platform API
The Emails & Activities app (E&A) is a useful tool that enables monday.com CRM customers to manage client communication in one centralized location. Each contact is logged and tracked in the app's timeline for easy access to important details and updates. Every item has its own E&A timeline where activities are logged.
Queries
You can use the timeline query to retrieve an item's timeline data via the API.
- Returns an array containing metadata about a specific item's E&A timeline
- Can only be queried directly at the root; can't be nested within another query
query {
timeline (id: 1234567890) {
timeline_items_page {
cursor
timeline_items {
id
content
}
}
}
}import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });
const query = `query ($timelineId: ID!) { timeline (id: $timelineId) { timeline_items_page { cursor timeline_items { id content } } } }`;
const variables = {
timelineId: 1234567890,
};
const response = await mondayApiClient.request(query, variables);Arguments
You can use the following argument to reduce the number of results returned in your timeline query.
| Argument | Description |
|---|---|
id ID! | The unique identifier of the item to retrieve timeline activities from. |
Fields
You can use the following field to specify what information your timeline query will return. Some fields support their own subfields.
Field | Description | Supported Subfields |
|---|---|---|
timeline_items_page | A paginated set of timeline items. | cursor |
