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:
- integration recipe
- custom action
- call authentication with JWT
- API
- remote options for custom fields
You can find more info in our QuickStart guide here
-
Make sure you have Node (v10+) and yarn installed
-
Use the correct node version:
$ nvm use
3. Install dependencies with yarn:
$ yarn install
- Open monday.com, login to your account and go to a "Developers" section.
- Create new "Integration Example App"
- Open "Features" section and create new "Integration" feature
- Open "Recipes" tab
- Click "Add new recipe"
- Click "Choose trigger" and choose "When a column changes" trigger
- Type "When {text column, columnId} changes" in "Sentence" field
- Configure trigger input fields:
boardId - Context
columnId - Recipe Sentence (Text Column)
- Click "Choose action"
- Click "Create new action"
- Name your action "Transform text"
- Type in "Run URL" field: https://{NGROK_URL}/transformation/transform
** we will update {NGROK_URL} placeholder later, when we will bring up our local server - Add the following input fields that our action will need in order to run:
Board - boardId
Item - itemId
Column - sourceColumnId
Column - targetColumnId
- Click "Create action"
- Choose your custom action in the recipe
- Type “transform to {another column, targetColumnId}” in "Sentence" field
- Configure action input fields
boardId - Trigger Output (boardId)
itemId - Trigger Output (itemId)
sourceColumnId - Trigger Output (columnId)
targetColumnId - Recipe Sentence (Text column type)
4.Click "Create Recipe" button
- 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
- Run the server with ngrok tunnel with the command:
$ npm start
3. Open http://localhost:4040/status to get your ngrok public url
4. Open custom action "Transform text" that we created before and update {NGROK_URL} part in "Run URL" field with the ngrok public url, that we just got
** Note that on every restart of the server, your ngrok url will change, so you need to change "Run URL" field in the action.
If you want to actively change server-side code and restart the server, you can run npm run server
and npm run expose
in 2 different terminal windows
- Go to any board at monday.com (it should have at least 2 text columns) and add your new integration recipe to it
- Configure source and target columns in your recipe
- Update the value in the source column and in a few moments the target one will be update with the transformed text
- Enjoy your recipe! "# mondayint-ts"