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:
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:
The feature in the automation center (custom automation)
The feature as a webhook trigger
The feature in the recipe editor