Custom Monday.com Integration

A Node.js + React integration for Monday.com that listens to board item column changes, then stores or updates item data in MongoDB. Built using the Monday.com GraphQL API and SDK, Express.js, and Mongoose.

🚀 Features

• Column Change Listener — Detects when item columns are updated on a Monday.com board via webhooks
• • MongoDB Sync — Stores new items or updates existing ones in MongoDB using custom item mapping
  • • GraphQL API — Communicates with Monday.com via GraphQL queries and mutations
    • • Custom Recipes — Uses Monday.com integration recipes (workflow blocks) with custom actions: "store in MongoDB" and "update in MongoDB"
      • • ngrok Support — Exposes local server for testing Monday.com webhooks during development

        • • MIT Licensed — Open source

          • 🛠 Tech Stack

          • | Layer | Technology |

          • |---|---|

          • | Server | Node.js, Express.js |

          • | Frontend | React.js |

          • | Database | MongoDB Atlas |

          • | ODM | Mongoose |

          • | API | Monday.com GraphQL API |

          • | SDK | Monday SDK (JS) |

          • | Dev Tool | ngrok (local tunneling) |

          • 📦 Languages

          • • JavaScript (primary)

            • • MIT License

              • ⚙️ Setup & Installation

              • Prerequisites

              • • Node.js installed
                • • MongoDB Atlas account
                  • Monday.com account with an app created

                  • ngrok installed

                  • Steps

                  • 1. Clone the repository

                    2. git clone https://github.com/moathmushtaha/custom-integration.git
                       cd custom-integration

                       2. Install dependencies

                       3. npm install

                          3. Configure environment variables — copy .env and fill in your values:

                          4. MONGODB_URI=your_mongodb_connection_string
                             MONDAY_SIGNING_SECRET=your_monday_app_signing_secret

                             4. Get your MongoDB URI from MongoDB Atlas

                             5. 5. Get your Monday signing secret from your app's Basic Information page (App Credentials section)

                                6. 6. Start the server

                                   7. npm run start

                                      7. Create a public URL using ngrok:

                                      8. ngrok http 8302

                                         8. Configure Monday.com — go to your app's Features, add an integration, and paste the ngrok URL

                                         9. 9. Create custom recipes (workflow blocks) with actions "store in MongoDB" or "update in MongoDB"

                                            10. 10. Add the recipe to your board and test it!

                                                11. 📊 How It Works

                                                13. A Monday.com board item column is updated by a user
                                                15. Monday.com triggers a webhook to the ngrok URL
                                                17. The Express.js server receives the webhook, validates the signing secret
                                                19. Item data is fetched from Monday.com via GraphQL

                                                21. The item is stored or updated in MongoDB using Mongoose

                                                22. 💡 Skills Demonstrated

                                                24. Monday.com API & SDK — webhooks, GraphQL queries/mutations, custom integrations
                                                26. Node.js / Express.js — REST webhook server
                                                28. MongoDB / Mongoose — NoSQL document storage and ODM
                                                30. GraphQL — data fetching from Monday.com
                                                32. React.js — frontend components for Monday.com apps
                                                34. Webhook-driven architecture — event-driven integration patterns
                                                36. ngrok / local tunneling — development workflow for webhook testing

                                                38. Third-party API integration — connecting external services via authenticated APIs

                                                39. 👤 Author

                                                40. Moath A. Mushtaha

                                                42. GitHub: @moathmushtaha

                                                43. 📄 License

                                                44. MIT