Skip to main content

monday.com Setup

Connecting monday.com to Caddi with a custom OAuth app

monday.com connects to Caddi through an OAuth app that you create in your own monday.com account's Developer Center.

Before you start

You'll need:

  • A monday.com Admin or Member account. Guests and viewers can't create apps.

  • Owner or Admin access to your Caddi organization

Step 1: Copy the redirect URL from Caddi

  1. In Caddi, open Settings, then Integrations.

  2. Under Connectors you can configure, find monday.com and click Configure.

  3. Click Copy redirect URL. It is https://app.trycaddi.com/oauth-callback. Keep this form open; you'll come back to it in Step 3.

Step 2: Create the app in monday.com

  1. Sign in to monday.com, click your profile picture in the top-right corner, and select Developers. The Developer Center opens in a new tab.

  2. Click Create app, enter an App Name such as Caddi and an App Slug, and click Create app. The slug can't be changed after you create the app.

  3. In the left sidebar under Build, click OAuth & Permissions.

  4. On the Scopes tab, select the scopes Caddi uses: me:read, account:read, boards:read, boards:write, workspaces:read, workspaces:write, users:read, updates:read, updates:write, docs:read, docs:write, assets:read, teams:read, tags:read, and notifications:write. me:read is required; Caddi uses it to identify you. monday.com requires the scopes Caddi requests to match the ones you select here.

  5. Switch to the Redirect URLs tab, add the redirect URL you copied in Step 1, and click Save.

  6. Turn on the New OAuth Flow toggle. monday.com sets this per app version, so turn it on for the draft version you're editing.

  7. Click Promote to live under your app's name in the left sidebar. You can also open the App versions tab, click the three dots in the Actions column for the draft version, and click Publish.

  8. Open the Install tab and click Install App.

  9. Open General settings, then App credentials, and copy the Client ID and Client Secret.

Do not send this secret by email, chat, or a support ticket. Paste it straight into Caddi in Step 3, or keep it in a password manager until you do.

Step 3: Add the credentials in Caddi

  1. Go back to the monday.com Configure form you opened in Step 1. If you closed it, open Settings, then Integrations, and under Connectors you can configure, find monday.com and click Configure.

  2. Paste the Client ID into Client ID.

  3. Paste the Client Secret into Client Secret.

  4. Click Save Configuration.

Step 4: Confirm the connection

  1. In Caddi, open Integrations in the left sidebar.

  2. Find monday.com and click Connect.

  3. Sign in to monday.com and approve the request. You'll be returned to Caddi with the connection active.

If you're not going to be an everyday user of Caddi, you can disconnect after confirming the connection works.

Sources

Did this answer your question?