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 as an activity in the app's timeline for easy access to important details and updates.

You can choose from default activities, like Meeting or Call Summary, or you can create custom activities to better organize your contacts.

Queries

Querying custom_activity will return metadata about custom activities in the E&A timeline. This method accepts no argument, returns an array, and can only be queried at the root.

query {
  custom_activity {
    color
    icon_id
    id
    name
    type
  }
}

let query = 'query { custom_activity { color icon_id id name type }}';

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)));

Fields

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

Field	Description
color `CustomActivityColor`	The custom activity's color. View a full list of names and their corresponding colors here.
icon_id `CustomActivityIcon`	The custom activity's icon. View a full list of names and their corresponding icons here.
id `ID`	The custom activity's unique identifier.
name `String`	The custom activity's name.
type `String`	The custom activity's type.

Mutations

Create a custom activity

The create_custom_activity mutation allows you to create a custom activity in the E&A app via the API. You can also specify what fields to query back from the new activity when you run the mutation.

mutation {
  create_custom_activity (color: SLATE_BLUE, icon_id: TRIPOD, name: "Test custom activity") {
    id
  }
}

let query = 'mutation { create_custom_activity (color: SLATE_BLUE, icon_id: TRIPOD, name: \"Test custom activity\") {	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 define the new custom activity.

Argument	Description	Enum values
color `CustomActivityColor!`	The custom activity's color. View a full list of names and their corresponding colors here.	`BRINK_PINK` `CELTIC_BLUE` `CORNFLOWER_BLUE` `DINGY_DUNGEON` `GO_GREEN` `GRAY` `LIGHT_DEEP_PINK` `LIGHT_HOT_PINK` `MAYA_BLUE` `MEDIUM_TURQUOISE` `PARADISE_PINK` `PHILIPPINE_GREEN` `PHILIPPINE_YELLOW` `SLATE_BLUE` `VIVID_CERULEAN` `YANKEES_BLUE` `YELLOW_GREEN` `YELLOW_ORANGE`
icon_id `CustomActivityIcon!`	The custom activity's icon. View a full list of names and their corresponding icons here.	`ASCENDING` `CAMERA` `CONFERENCE` `FLAG` `GIFT` `HEADPHONES` `HOMEKEYS` `LOCATION` `NOTEBOOK` `PAPERPLANE` `PLANE` `PLIERS` `TRIPOD` `TWOFLAGS` `UTENSILS`
name `String!`	The custom activity's name.

Delete a custom activity

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

mutation {
  delete_custom_activity (id: "cbb37d0e-04ee-3662-z832-c4150e80eddz") {
    name
  }
}

let query = 'mutation { delete_custom_activity (id: \"cbb37d0e-04ee-3662-z832-c4150e80eddz\") {	name }}';

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 define which custom activity to delete.

Argument	Description
id `String!`	The custom activity's unique identifier.