Why monday.com? Product Stories Pricing Careers Log in
App store
What can we help you with?
  1. Support
  2. Become a Pro
  3. Integrations
Webhook Integration
    Was this article helpful?
    15 out of 18 found this helpful

    Webhook Integration

    Screen_Shot_2020-03-08_at_17.47.27.png

     

     

    As we expend our integrations ability we offer and settings the foundations for our vision to turn your monday.com account into your own personal work hub,  we now offer the ability to have a webhook API connection that will allow you to improve your API integrations as the integration we already offer as part of the platform. 

     

    So what is a Webhook?

    Webhook (also called a web callback or HTTP push API) is a way for an app to provide other applications with real-time information. A Webhook delivers data to other applications as it happens, meaning you get data immediately unlike typical APIs where you would need to poll for data very frequently in order to get it real-time. This makes Webhooks much more efficient for both provider and consumer. The only drawback to Webhooks is the difficulty of initially setting them up.

     

    How to create a new Webhook 

    Step 1

    On your board, click the "integrations" icon and look for the "Webhooks" app while adding new integration.

    eee.png

    Once in the integration center, click on Webhook as below: 

    1.png

     

    Step 2

    Choose the action you want the webhook to be ״hook״ to : 

     2.png

     

    Step 3

    After choosing the action you need, you will need to specify the URL According to the integration that you want to get the webhooks: 

    ww.png

    From that moment on, using the webhook integration, the API you set will deliver data to other applications as it happens, meaning you get data immediately.

     

    How to verify a webhook URL ?

    The URL you specified should be of course controlled by your app, and we're verifying that by a verification request we're making while you're listing a new URL.

    We will send a json POST body containing a "challenge" field, which is a random token that we expect you to return as a "challenge" field of your response json body to that request.

    Here is how the "Challenge" will look like:

    The verification request is a POST request to the defined URL with the following payload:

    {
     challenge: “3eZbrw1aBm2rZgRNFdxV2595E9CY3gmdALWMmHkvFXO7tYXAYM8P”
    }

     

    The response body should be a json object that looks the same:

    {
     challenge: “3eZbrw1aBm2rZgRNFdxV2595E9CY3gmdALWMmHkvFXO7tYXAYM8P”
    }

     

    How the events will look like?

    Each webhook request post request will have a type field and an event field in its body.
    The type field tells you what the events stand for, and the event will contain the payload with the event's data.
     
    Here is an example of "when a item is created" : 
    
{
  type: 'create_item',
  event: {
    boardId: 224535,
    groupId: '224132',
    groupName: 'This Week',
    itemId: 983678,
    itemName: 'A new task',
    userId: 103892
  }
}

     

    Tip: Want to learn more about our integrations and automations? check out our dedicated support section - link

     

    More assistance

    If you need help building custom integrations, we also have an option for paid assistance through our network of certified monday.com partners. If you're interested, please fill out this form and someone will be in touch shortly!

     

    If you have any questions about this or anything else in this article, feel free to reach out to us at customer success at [email protected] 

     

    Doron -

    Comments