Skip to content

Managing Webhooks

You can open the Webhook management drawer by clicking on the settings button next to the Webhook on the dashboard.

Manage Webhook Drawer

Mapping Request Data to Board Columns

The Webhook settings drawer includes the Field Mapping section, where you can define how fields in the request payload should be mapped to the columns on the connected board.

To map a field, choose the target column from the dropdown and enter the JSON path for the source field. Nested JSON fields can be accessed using dot notation, where each period indicates a deeper level of nesting within the JSON data.

Here's an example request payload:

request.json
1
2
3
4
5
6
{
  "name": "The National",
  "details": {
    "description": "Cool Band"
  }
}

We want to map the value of the name field to the Name column, and the value of details.description to the Description column. Here’s what our field mapping would look like:

Field Mapping Example

Note

Every item in monday.com must include a Name column, which serves as an identifier. Therefore, each Webhook requires a field to be mapped to the Name column.

Authentication

Note

Authentication is only available on the Pro subscription.

To secure your webhooks, you can enable authentication. Toggle the authentication switch on and specify a name for the authorization header. HookPanda will then inspect incoming requests and reject any that:

  • Are missing the specified header, or
  • Include a header with a value that doesn't match the auto-generated token.

Rejected requests will receive an HTTP 401 Unauthorized response.