Skip to content

Monday.com

Install Monday.com integration

The Monday.com integration can be found here. Please install it in your environments before proceeding with the steps below.

Set up your Monday.com OAuth app

Truto doesn't ship a Monday.com OAuth app of its own. Before your end users can connect with OAuth, bring yours:

  1. Sign in to your Monday.com account and click Developers in the top-right menu. 'Click on developer button in Monday.com'
  2. In the Monday Developer Center, choose Build App and configure your app. Under OAuth, add https://api.truto.one/connect/mondaycom/callback as a redirect URL. If you use a redirect URL on your own domain, add that URL instead. 'Click on live and create app'
  3. Copy the app's Client ID and Client Secret, and enter them on the installed Monday.com integration. See Overriding OAuth credentials. 'Client Id and Secret'
Info

Until you add them, the connect UI offers Monday.com only through the API Key method.

Connecting a Monday.com account

  1. Click on Connect Account 'Click connect account'
  2. Type in a value for the Tenant ID. This can be an ID of your choosing. And then click on Get connection link 'Get connection link'
  3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too and they will be able to connect their Monday account. 'Share connection link'
  4. Select Monday.com 'Select Monday.com'
  5. Choose how to connect:
    • OAuth 2.0 (offered once you add your Monday.com app): log in to Monday.com and allow access.
    • API Key: enter an Access Token. In Monday.com, click your profile picture, select Developers, and copy the token under My access tokens.
  6. You should now see a connection successful message. You can now close this tab.

Uninstalling the Monday.com integration

  1. To uninstall the Monday.com integration from your Truto account, select the Monday.com integration from the Integrations tab.

  2. Click on the Settings tab in Monday.com Integration page

  3. And then click on Uninstall. Uninstalling the integration will also remove all the Monday.com integrated accounts from your Truto account.

'Uninstall Monday.com'

Setting up Unified Webhooks for Monday.com

Info

Currently, Monday.com only supports Unified Webhooks for their App life cycle events.

Setting up Webhooks in Truto

  1. Login to https://app.truto.one/ and navigate to Webhooks tab
  2. Click on the Create Webhook button and modal shows up.
  3. Enter your endpoint URL in the Endpoint input to which you would like to get the webhook events posted.
  4. Set the webhook to Active to start listening to the events.
  5. Choose record:meta only get the events related to the Unified Webhooks for Monday.com or select “all” to receive all the events.
  6. Click on Create Webhook to save the webhook. 'Webhook Modal'

Connecting Webhooks from Monday.com to Truto

  1. Go to your Monday.com account and click on the Developers button at the top right User Profile menu.
  2. In the Monday Developer Center, choose the application for which you would like to set up webhooks.
  3. Click on the Webhooks tab under the Manage section. 'Monday.com Webhooks'
  4. Enter the target URL in the following format - https://api.truto.one/environment-integration-webhook/<your_environment_integration_id>
    1. You can find the environment_integration_id from the Truto UI by navigating to the following URL and select the environment for which you are setting up webhooks - https://app.truto.one/integrations/installed?search=mondaycom
    2. You can also refer to the following GIF to find the environment_integration_id - 'Find environment_integration_id'
  5. Once the API URL is added, save the changes and publish the Monday.com app to Live.