/monday-code-template

Primary LanguageJavaScriptMIT LicenseMIT

Overview

This is the "Quickstart Integration" example Monday app.
It can be used as a board recipe, which transforms data from one text column to another


This app demonstrates how to use the:

  • integration recipe
  • custom action
  • call authentication with JWT
  • query monday API using short lived token (seamless authentication)
  • remote options for custom fields


You can find more info in our QuickStart guide here
Screenshot

Install

  1. Make sure you have Node (v16.16+) and npm installed

  2. Run node modules install:

$ npm install

Configure your Monday App

Part One: Create a new app and integration feature

  1. Open monday.com, login to your account and go to a "Developers" section.
  2. Create new "Integration Example App"
  3. Open "Features" section and create new "Integration" feature
  4. Choose the "Quickstart Integration - NodeJS" template to start. Add in the missing scopes, run the command scaffold in your command line, and paste the resulting URL into the URL box.


Screenshot

Part Two: Update your integration's basic information

In the feature editor, open the "Feature Details" tab. This tab allows you to add a title and description to your custom integration recipe. The user will see the title and description when they see your recipe in the Integrations Center.


Screenshot

Part Three: Recipe configuration

Our new feature templates provide the integration recipe for you, so it is ready to go.


Screenshot

This integration utilizes a custom action that calls our API to update a second text column. If you want to see the code behind this recipe, navigate into the "quickstart-integrations" folder downloaded onto your computer after you ran the command line prompt in Part 1.

In short, integrations run off of triggers that invoke certain actions. These triggers are the conditions that must be met before an action can take place.

Part Four: Run the project

  1. Add your MONDAY_SIGNING_SECRET to .env file
    ** To get your MONDAY_SIGNING_SECRET go to monday.com, open Developers section, open your app and find the Signing Secret in "Basic Information" section
    Screenshot
  2. Run the server with ngrok tunnel with the command:
$ npm start
  1. Open http://localhost:4040/status to get your ngrok public url

Part Five: Using the custom integration recipe

You're done! Head to any of your boards to add the integration recipe by searching for its name (in this example the integration name is "New Feature").

Follow the integration recipe prompts as normal (selecting which Text columns you want) and watch the magic unfold!