We recently released the app settings view, which provides a global location to display an app's settings! This feature is not a traditional view but functions similarly by enabling developers to render any content inside an iframe.

Users can access this view using the Settings tab on the Installed apps page. They can also select the Go to app settings button in View settings or click on their profile picture > Admin > Apps > three dots (...) > Settings. These buttons will open the Settings tab on the Installed apps page. A standalone modal with the settings view will open up if your app isn't listed on the marketplace.

Checkout our quickstart guide to learn how to implement this new feature!

Users will now receive a notification from monday when an app's trial period expires and will be prompted to pick a new plan to continue using the app. Check out our extending trials doc to see what the notification will look like!

Hello everyone!

We have now released to 100% of monday accounts, the ability to choose to install apps from the marketplace in specific workspaces (1 or more of them) or in all of the account’s workspaces.

The accounts now have more control over which workspaces an app has access to. The app will only be able access data from the specified workspaces so it only gets the information it needs to function 💪

We’re excited to announce the value-created type in our SDK!

This new type will track the time between when a user installs your application and when they get value from it. You will determine what actions are considered valuable.

You can call the monday.execute() method with the valueCreatedForUser type each time the valuable action happens:

monday.execute('valueCreatedForUser')

To analyze the amount of time it takes users to get value from our apps, we need your help in implementing this feature!

After executing this method, you won’t see any immediate changes. We plan on exposing these insights to app developers and adding more telemetry about app usage in the future.

To learn more about the value-created type, please see Value-created event best practices

Happy building! 🛠

We have some exciting documentation news 🚀

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.

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 ⚒️

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"
  }