What can we help you with?

Webhook Integration

 

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.

1.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: 

1.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!

This is a Beta feature, to learn more about our beta features click here 

 

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]