🚧

Only available in API version 2024-10

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.

Queries

Querying timeline_item will return metadata about newly created items in the E&A timeline. This method accepts one argument, returns an array, and can only be queried at the root.

Please note that currently you can only query timeline items created through the create_timeline_item mutation, so it isn't possible to query existing timeline items. The id argument is required to query a timeline item, and the only way to retrieve it is by querying it back after running the create_timeline_item mutation.

query {
  timeline_item (id: "6376175611") {
    board {
      id
    }
    item {
      name
    }
    id
    ref_id
    user {
      id
      name
    }
    title
    type
  }
}

Arguments

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

Fields

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

Mutations

Create a timeline item

The create_timeline_item mutation allows you to create a new timeline item in the E&A app via the API. You can also specify what fields to query back from the new item when you run the mutation. Please note that currently, this is the only way you can retrieve a timeline item's ID. It is not possible to retrieve it from the UI.

mutation {
	create_timeline_item (
  item_id: 9876543210,
  title: "Migrated Email",
  summary: "internal company email",
  content: "From: [email protected] <br> To: [email protected] [Asi Monday], [email protected] [Yoni Monday] <br> Subject: Deploy our first alpha version <br><br>Hey guys, <br>We are ready to deploy our first alpha version and enable<br>our clients to migrate into E&A!<br><br>Best regards,<br> Saar",
	timestamp: "2024-06-06T18:00:30Z",
  time_range: {
   start_timestamp: "2024-05-06T18:00:30Z", 
   end_timestamp: "2024-05-06T19:00:30Z"
  }
 ) {
  id
 }
}

Arguments

You can use the following argument(s) to define the new timeline item's characteristics.

Delete a timeline item

The delete_timeline_item mutation allows you to delete a timeline item in the E&A app via the API. You can also specify what fields to query back from the deleted item when you run the mutation.

mutation {
  delete_timeline_item (id: 1234567890) {
    id
  }
}

Arguments

You can use the following argument to define which timeline item to delete.