How to configure Monday.com for the integration with ONEiO

Introduction

This document shows an example of what needs to be done in Monday.com to make it integration-ready with an endpoint in your ONEiO subscription. Your instance will be ready in two simple steps by generating a personal API token and adding a set of webhooks.

Generating a token

For ONEiO to interact with Monday.com API we need to generate and supply your endpoint with an authorization token. It's recommended that the token is generated on behalf of a dedicated integration user. The notable part is that the user needs to have admin privileges in your instance. Follow the instructions from Monday.com to obtain the token. 

Once retrieved we need to update the endpoint in the oneio app with the value:

Creating a webhook

For ONEiO to receive information about your items in Monday.com we need to create a set of webhooks for the relevant for your use-case events. For basic integration, it will be sufficient to add "when an item is created", "when a new update is posted" and "when any column changes". To create a webhook, please follow the guide provided by Monday.com. When prompted to enter the URL please head to the oneio app and use the "Generate new password" function. You can then copy the complete webhook address to Monday.com.