Notifications

Notifications are used by monday.com to alert users of actions inside their workflows. They are sent in response to events such as due dates, updates, and more.

By default, a user will also receive an email when they receive a notification. This can be turned off and customized in the user’s profile settings.

📘

Looking to find out more about how notificaiions work in monday.com? Please feel free to take a look at the resources below:

Notification Mutations

Required scope: notifications:write

Create a Notification

The create_notification mutation allows to trigger a notification within the platform (will also send out an email if the recipient's email preferences are set up accordingly). Please keep in mind that notifications are async and you will not be able to query their IDs back after sending them out.

mutation {
    create_notification (user_id: 105939, target_id: 674387, text: "This is a notification", target_type: Project) {
        text
    }
}
let query = "mutation { create_notification (user_id: 105939, target_id: 674387, text: \"This is a notification\", target_type: project) { text } }";

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)));
curl --location --request POST 'https://api.monday.com/v2' \
--header 'Authorization: YourSuperSecretAPIkey' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cf_bm=edddcd501f9a83ce01c7b30aed23be250fad66c4-1623684217-1800-AVtP8ukCWPcTm+faTZN78dox7PcvRJ7cu4kjGxUPi2PrB5/uE5uaLukXIGFxf8icCVw1HVeIHscrYNQphlsv0UE=' \
--data-raw '{"query":"mutation {create_notification (user_id: 9603417, target_id: 1049711445, text: \"This is a notification\", target_type: Post) { text }}"}'

Arguments

The following create_notification arguments determine the notification's characteristics.

Argument

Description

text !String

The notification text.

user_id !Int

The user's unique identifier.

target_id !Int

The target's identifier.

target_type !NotificationTargetType

The target's type (Project / Post)

📘

NOTE

The target_type argument has two different options:

  • Projects will refer to Items or Boards. Use the item or board ID as the target ID.
  • Posts will refer to Updates posted to items as replies or new updates. Use the update or reply ID to send the notification related to this update.

Did this page help you?