*Version: 1.0 | Last Updated: 2025-02-25* ## Overview - **Integration Name:** Monday - **Purpose:** Integrate MoovingON AI with Monday platform - **Audience:** Support team, TAM - **Prerequisites:** - A valid Monday account - MoovingON AI account access with integration permissions --- ## Table of Contents - [[#Setup Instructions]] - [[#Configuration]] - [[#Testing the Integration]] - [[#Related Links]] --- ## Setup Instructions Webhook should be created in MoovingON AI platform to send alerts to Monday. 1. **Step 1:** Webhook should be created in settings **** 2. **Step 2:** Click on the **Plus** symbol in the upper bar: **** 3. **Step 3:** On the right side of the screen, a window will appear to create the webhook. The parameters: - **Name**: Webhook's name - **Method**: POST - **Content-Type**: JSON - **URL**: This is the URL used to open the task in Monday "https://api.monday.com/v2" - **Payload**: The alert details for the alert created on Monday: Here is the payload used for opening a task: { "query": "mutation {create_item (board_id: BOARD_ID, group_id: \"GROUP_ID\", item_name: \"ITEM_NAME\") {id}}" } **NOTE**: BOARD_ID , GROUP_ID , ITEM_NAME should be replaced with the relevant values. (explained in [[#Configuration]]) - Authorization: A header should be added by clicking "**Add Header**". The value field should contain "{APIKey}". The key was extracted from Monday (explained in [[#Configuration]]). **** --- ## Configuration 1. **Extracting the API token**: - Log in to your monday.com account. - Click on your avatar/profile picture in the top right corner. - Select **Administration** > **Connections** > **API**. - Copy your personal token. **Please note** that you can always regenerate a new token, but doing so will cause any previous tokens to expire. 2. **Extracting Board IDs**: To extract the board IDs, we have to use this API request: curl --location 'https://api.monday.com/v2' \ --header 'Authorization: RELEVANT_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "query": "query {boards{id name}}" }' 3. **Extracting Groups IDs**: To extract the group IDs, we have to use this API request: curl --location 'https://api.monday.com/v2' \ --header 'Authorization: RELEVANT_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "query": "query {boards (ids: BOARD_ID) {groups {title id}}}" }' --- ## Testing the Integration - **Test Case:** By running the webhook on alert, we receive this response: **** We can see that it appears on Monday as well: **** --- ## Related Links - **External Resources:** [Authentication](https://developer.monday.com/api-reference/docs/authentication) , [PostMan Collection](https://www.postman.com/matiasdavidson1/my-workspace/request/ra7khwt/create-an-item)