Reference
Apps DocsCommunity

Timeline

Learn how to read an item's Email & Activities timeline using the platform API

🚧

Only available in API versions 2025-01 and later

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. You can use the timeline endpoint to query a specific item's timeline.

Queries

  • Returns an array containing metadata about a specific item's E&A timeline
  • Can only be queried directly at the root
query {
 timeline(id: 1234567890, limit: 5, cursor: "TXlDb2RlU3RyaW5nMTIzNDU2NzgsNzg5MCxzb21lRGF0YT1Bbm90aGVyVmFsdWU=") {
  timeine_items_page {
   cursor
  }
  timeline_items {
    title
    custom_activity_id
    board {
      workspace_id
   }
  }
 }

let query = "query { timeline (id: 1234567890, limit: 5, cursor: \"TXlDb2RlU3RyaW5nMTIzNDU2NzgsNzg5MCxzb21lRGF0YT1Bbm90aGVyVmFsdWU=\") { timeline_items_page { cursor } timeline_items { title custom_activity_id board { workspace_id }}}}";

fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE'
   },
   body: JSON.stringify({
     query : query
   })
  })
   .then(res => res.json())
   .then(res => console.log(JSON.stringify(res, null, 2)));

Arguments

You can use the following argument(s) to reduce the number of results returned in your timeline query.

ArgumentDescription
cursor StringAn opaque token representing the position in a set of results to fetch timeline activities from. Use this to paginate through large result sets.
id ID!The unique identifier of the item to retrieve timeline activities from.
limit IntThe number of timeline activities to retrieve.

Fields

You can use the following field(s) to specify what information your timeline query will return.

FieldDescriptionSupported fields
timeline_items [TimelineItem!]The items in the timeline.
timeline_items_page TimelineItemsPageResponseContains the cursor to obtain the next set of timeline items.cursor String