Happy Monday from us here at monday.com!

We've been working on a new feature that allows users to rate marketplace apps installed on their accounts. These ratings will give users more confidence when installing apps and enable developers to improve their apps based on user feedback. It's a win-win situation!

You can read all about the new feature and find answers to the most frequently asked questions in this document!

Hello all!

We have some exciting documentation news today 🚀

We have moved our documentation to be hosted on developer.monday.com. This change will provide you with a more unified experience when navigating and searching through our API and App Framework documentation.


After September 17th, the old URLs (api.developer.monday.com and apps.developer.monday.com) will no longer work.

Be sure to update your bookmarks accordingly.

If you see any broken links, please let us know at [email protected]!

Happy building ⚒️

We have added some information in the payload for the install and uninstall webhooks for apps:

  • User name: The full name of the user who installs or uninstalls the app (example: John Doe)
  • Account tier: The account's tier in monday (free/basic/standard/pro/enterprise/trial(will be null in that case))
  • Account max users: The maximum amount of seats the account can have (example: 20)
  • User cluster: The user's area of work (example: HR)

Example of an install webhook's payload:

{
  "type":"install",
  "data":{
    "app_id":1000000000,
    "user_id":3,
    "user_email":"[email protected]",
    "account_id":1,
    "version_data":{
      "major":1,
      "minor":2,
      "patch":0,
      "type":"minor",
      "user_name": "John Doe",
      "account_tier": "standard",
      "account_max_users": 20,
      "user_cluster": "ngo",
    },
    "timestamp":"2022-06-28T06:48:06.643+00:00",
    "subscription":{
      "plan_id":"plan2",
      "renewal_date":"2022-07-19T00:00:00+00:00",
      "is_trial":false,
      "billing_period":"monthly",
      "days_left":21
    }
  }
}

We have some news for you 🙂

From now on, the webhooks used to notify your app when it gets installed or uninstalled will be sent to the same endpoint. You can specify the endpoint you want to use in the "Webhooks" section of your app's configuration screen.

To that endpoint we will also send a webhook when a subscription is created, when a subscription changes, and when a subscription is canceled.

You will be able to tell them apart because each webhook will have a specific "event" field.

Your old install and uninstall URLs will be valid until you specify an endpoint in the "Webhooks" section. Once you have specified an endpoint in this section, your old install and uninstall webhooks will no longer work.

Learn more about this here and here.

The app installation webhook will now include the email of the admin who installed the application. The same will apply for uninstalls.

Having user emails can help facilitate communication with your users about topics such as app onboarding, support channels, frequently asked questions and other exciting product announcements.

Be sure to avoid using user emails to distribute spam and provide the option for users to opt-out.

Below is an example of what the payload will look like when the app installation webhook is triggered:

{
    "app_id": 12345678,
    "user_id": 90123456,
    "user_email": "[email protected]",
    "account_id": 12121221,
    "version_data": {
      "major": 1,
      "minor": 0,
      "patch": 0,
      "type": "major"
    },
    "type": "install",
    "timestamp": "2022-06-01T19:23:24.054+00:00"
  }

We have amazing news!

Four new members have joined our webhooks family 🎉

We are thrilled to announce that these long awaited webhooks are here:
1. When a subitem is deleted
2. When an item is deleted
3. When a subitem is archived
4. When an item is archived

Use them wisely 😎

We have added the possibility to use the changing of an item's name as a trigger!

This is available, in the automation center, in the recipe builder and as a trigger for a webhook:

527

The feature in the automation center (custom automation)

398

The feature as a webhook trigger

2564

The feature in the recipe editor

Today we hit a big milestone – board IDs for new boards are now larger than 2147483647. Our users are creating more boards and workflows than ever!

This also means they cannot be stored as integers. More specifically, they are too large to be stored as a 32-bit signed int.

If you are currently handling board and item IDs in your application as integers, you need to update your application to use another data type such as bigInt.

You will also need to run migrations on any databases that store board IDs as integers, as they will fail to store any new board IDs.

We are proud to announce the latest version of the monday style guide — Monday Vibe!

It’s a brand-new central repository for all things monday style: React components, style guidelines, and UI notes in one place. Check it out at style.monday.com!

882

Monday vibe features:

  • Full design guidelines to design your apps like monday’s own design guild
  • 26 components for you to use in your apps
  • A sandbox for testing each component
  • Styleguides for fonts, animation, and presentations
  • A logo library

We have also updated the Monday UI kit and you can check it out here!

Thank you to all the team for your contributions.

Happy building 🔧

We just released an amazing feature that will make your apps much more flexible for your users 💪

Now, your triggers and actions can be added to the automation center, so your users can incorporate them in their custom recipes.

Check out our full documentation here: Workflow Blocks