Product updates

We just added the direction and symbol fields on the NumbersValue implementation. You can use these fields to return information about the symbols used in Numbers columns. Check out the details here! Please note that the NumbersValue implementation is only available in API version 2023-10 and later. Sample query query { items (ids:[9876543210]) { column_values { ... on NumbersValue { number id symbol direction } } } } Returns { "data": { "items": [ { "column_values": [ { "number": 10, "id": "numbers", "symbol": "$", "direction": "left" } ] } ] }, "account_id": 1234567 }

Hey developers! We have an important update regarding the creation of workspace templates on our platform. Previously, there were no limits on the number of entities included in a workspace template. While this allowed for significant flexibility, it also had some drawbacks. One major concern with unlimited entities was the potential for overloading the system, resulting in decreased performance and reliability. This was particularly noticeable during the installation phase, which heavily relies on the number of entities within the app. To address this issue, we have decided to set a limit on the number of entities included in an app 50 boards, dashboards, and documents in each workspace template. Up to 10K items across all boards. If you have an app that exceeds this limit it will still be able to be installed, but it will not be able to be upgraded to the latest version unless reduced below the limitations. New apps will be forced to mind the publishing limitation. When should you expect that to change? Dec 23rd 2023 We ask that you review your apps and ensure they fall within this updated constraint. By implementing this limit, we aim to improve system responsiveness and maintain a reliable experience for all users. We appreciate your cooperation in keeping our platform optimized.

We just added the section query parameter that enables you to create a custom URL that opens a specific section of your app listing page. Your custom URL can open directly on the Overview, Pricing, Security & Compliance, or Permissions tab. Check out our documentation for examples!

In API version 2023-10 and later, you can add the ids argument to an updates query to retrieve a specific update(s) using its ID. You can use the argument when querying updates at the root or while nested under boards or items. Please note that when nesting updates in a boards or items query, the ids argument will only return updates matching the ID that are also related to the board or item. The following example would only return information about update 9876543210 on item 1234567890. query { items (ids: 1234567890) { updates (ids: 9876543210) { body created_at } } }

We’re excited to introduce two new app subscription webhooks: The app_subscription_renewal_attempt_failure webhook will be sent to developers when a subscription renewal attempt fails. The attempt will occur once before the entire renewal operation fails and you receive the app_subscription_renewal_failure webhook. The app_subscription_renewal_failure webhook will be sent to developers when a subscription renewal attempt fails. The failure occurs after one renewal attempt. You can read more about our available webhooks here!

The new app_installs object allows you to retrieve your app’s installation data through the API. Your query can return most of the same installation information sent through webhooks. This new object is available in API versions 2024-01 and later. Check out our documentation for more info! query { app_installs (app_id: 123456789, limit: 1, page: 1) { app_id timestamp app_install_account { id } app_install_user { id } app_version { major minor patch type text } } }

We’re excited to announce that you can now host your applications on monday’s servers using monday code! Releasing this to beta is the first step in making the monday.com development process as easy and self-contained as possible. As an added bonus, marketplace apps hosted on monday code will also be eligible for an advanced security badge in the future. To use this feature, you’ll need to: Enable it in your developer account Use our CLI to deploy your code Install @mondaycom/apps-sdk to use our secure storage, logging, and environment manager in your app You can check out the full guide here!

Marketplace developers - this one is for you! Starting tomorrow, the minimum threshold for app ratings to appear in the marketplace will increase from 3 to 5! This means that the average rating will not be visible to marketplace users for any apps with less than 5 ratings. If your app has fewer than 5 ratings, users will still see your app card but it won’t have the average score on it. If your app has more than 5 ratings, users will see a star and the average score of all ratings listed on the app card. Check out our documentation for ways to help increase the number of ratings your app has received!

Thank you to everyone who joined my API training earlier this week. Here’s a recording of the session - I know I talk very fast, so I’m sure there are things you’ll want to rewatch 🚅 As a reminder, here are the resources I went over in the training (and others that might be useful): Release Notes – follow the links to see an explanation of each change New version migration guide API Documentation If you have any questions, post them as a new topic in the monday apps section of the community!

Hi community! As you know, the updated 2023-10 API version is stable and ready for production. Next week - on Wednesday – I’ll be hosting a webinar on the migration process. It’ll cover the same info as the training at the end of August, but is a great opportunity to get a refresher or answer any lingering questions you might have. The topics we’ll cover: New features & breaking changes in the updated version Migration guide for product developers and account admins Timeline How to switch between versions The online session will be held on Oct 25 @ 9:30am EST / 1:30pm GMT Register here

Marketplace app developers - this one is for you! When accessing your app in the Developer Center, you may notice an updated menu on the left-hand side that includes the brand-new Marketplace section. Here you’ll find tabs that are only relevant for marketplace apps to help make the menu more organized and the necessary tabs easier to access. Check out our documentation to read more about the sections and what each tab contains!

I’m here to deliver some good news regarding seamless authentication via the SDK… The shortLivedToken is now valid for 5 minutes instead of 1 🥳 This change will give your app an additional four minutes to make authenticated calls to the API as part of your integration recipe. You can read more about seamless authentication for integrations in our documentation. Happy authenticating!

Hello wonderful community! Dipro here, dropping in with a quick note about the new API version that we’ve been discussing here for the last few months 🔮 Version 2023-10 is now stable, meaning you can confidently use it in production (as of Oct 1, 2023). If you missed our previous announcements about this, here’s some context: Why should I care? This upgrade uses mondayDB, our new proprietary data infrastructure. It also contains quality-of-life improvements like sorting, filtering, and a more consistent way to access column data. Note that there are breaking changes in this release - any apps using deprecated queries should update their usage by January 15th 2024 otherwise they might break. What does this mean for me? Application developers: Rebuild the relevant logic in your apps to use the new API correctly. Anyone using Make, Zapier, or other 3rd party integration tools: These integration providers are updating their connectors. In the coming weeks, they will send you communication on what changes you’ll need to make in your workflow. How can I learn more? Read a list of all the changes – Release notes Read this migration guide – Migrating to version 2023-10 Watch this recent training – API Migration Bootcamp

We released API version 2024-01 on October 1st. It contains just one breaking change to give you more time to focus on the changes previously announced in 2023-10. Check it out below! Here’s what’s new Breaking changes Typo fix in UserUnauthorizedException error

Hi Community In light of the success of his last post and all the great feedback he received from you on Webhooks , Greg, who is leading the apps framework here on monday.com is inviting you to a private call with him. 💻 Why? Greg is looking to get more insights from you regarding the apps framework, and to consult with you on new features that are coming soon. 👂🏽 🎧 How? Here is a link to schedule a session with him. 🔗 Another excellent opportunity for us to learn and for you to influence

We recently added the ability to sort and filter items_page results by either their last updated or creation dates. You can do so by entering either "__creation_log__" or "__last_updated__" as the column ID in the order_by field of your query. The items will be returned chronologically, with the oldest listed first. Please note that you are not required to have a last updated or creation log column on your board to use this sorting mechanism. The following example would return the first 50 items on board 1234567890 with a blank status column value, and they would be listed chronologically (oldest to newest) according to their creation date. query { boards (ids: 1234567890){ items_page (limit: 50, query_params: {order_by: [{column_id: "__creation_log__"}], rules: [{column_id: "status", compare_value: [5]}], operator: and}) { cursor items { id name } } } }

We’ve recently made a few updates and improvements to our webhooks to help provide you with a better developer experience. Let’s check them out! 👀 New app_webhooks_only argument This new argument returns just the webhooks created by the app initiating the request when querying the webhooks object through the API. query { webhooks (app_webhooks_only:true, board_id:1234567890) { id event config } } Missing authorization headers Before these updates, we were missing a feature that sent the authorization header for some webhooks. We added the missing feature, so now the authorization header will be included in all webhooks. Make sure to start validating your requests from monday! Please note that this only applies to apps created in the Developer Center. You will not receive the authorization header if your app uses a personal token. Users can’t remove app webhooks in the UI While webhooks created by apps were always labeled internally on monday as belonging to a specific app, we enabled this labeling in the Active integrations page on the board so users can’t remove your webhooks from the board!

In the 2023-10 API release, we introduced the items_page object which utilizes cursor-based pagination to retrieve smaller groups of items from a large data set. This object must be nested inside of a boards query, so it has a high complexity cost. To help reduce that cost, we created the next_items_page object which can be used at the root of your query to paginate through the data set. It takes both the cursor and limit arguments and retrieves the following page of items in the data set. Now let’s break it down a bit… Say you only want to retrieve items with a blank status column from board 1234567890. This board contains thousands of items that cannot be retrieved simultaneously, so you can use cursor-based pagination. The query below would return the ID and name of the first 50 items with a blank status column and a cursor value that represents the position in the data set after returning 50 items. query { boards (ids:1234567890) { items_page (limit: 50, query_params: {rules: {column_id: "status", compare_value: [5], operator:any_of}}) { cursor items { id name } } } } You can then use the next_items_page object with the cursor argument from the first query to return the following 50 relevant items in the data set. After returning the next cursor value, you can continue paginating through the entire data set. query { next_items_page (limit: 50, cursor: "MSw5NzI4MDA5MDAsaV9YcmxJb0p1VEdYc1VWeGlxeF9kLDg4MiwzNXw0MTQ1NzU1MTE5") { cursor items { id name } } }

We have removed support for the text field on MirrorValue, DependencyValue, and BoardRelationValue column values. We have replaced it with the new display_value field to return text values for the connect boards, dependency, and mirror columns. As part of the 2023-10 release, we created the text field on column_values to return the text values for each column. These calls have a high cost for the mirror, dependency, and connect board columns. Therefore, we stopped supporting the text field and created the display_value field on these three column values only. These updates will help reduce the load by only returning the data when users actually need it. The following example would return the mirror column display values (i.e., text values) on items 1234567890 and 9876543210. query { items (ids:[1234567890, 9876543210]) { column_values { ... on MirrorValue { display_value } } } }

Hi community! It just occurred to us that we are experiencing problems uninstalling apps. The tech team is working on that and it should be fixed in the next few hours.

Hey community! We wanted to let you know that two weeks ago, we made a minor change to the “unsubscribe” behavior of the custom triggers for the Integration/Workflow app feature. Previously, the trigger’s unsubscribe endpoint was only called when the integration or board was deleted. However, we’ve now updated it to also unsubscribe for 3 days (subject to change in the future) after the automation was disabled. The reason for this change is to streamline resources and unsubscribe stale automations that have been out of use for more than 3 days. Prior to this change, such automations could remain disabled but also subscribed to indefinitely, wasting resources on both ends. This change will help both the apps infrastructure and app developers infrastructure save resources, and only trigger truly active automations moving forward. We hope this change makes your app experience even better. 💪🏼 If you have questions or concerns, please contact us. 🌸

We recently updated the DependencyValue implementation, so you can now return both the linked_items and the linked_item_ids for dependency columns when querying through column_values V2. Please note that the DependencyValue implementation is only available in version 2023-10. query { items (ids:[1234567890, 9876543210]) { column_values { ... on DependencyValue { linked_item_ids linked_items } } } }

Hello everyone who joined the webinar today! First off, apologies for the abrupt end to the meeting… We had some technical issues and were dropped from Zoom. Here are some resources that I discussed on the call: Webinar recording Query samples that we covered Release notes with all changes Migration guide Guide to column names and what’s changing PS @PolishedGeek – I was in the middle of your question when we dropped off. Make will be migrating their connector to the new API. I’ve reached out to them already – they are aware of these changes and making the required updates. I don’t know the exact status of it though; if you need a timeline please reach out to them for the most updated information. I will write up the other questions here and post them later today (along with the recording).

The new after_column_id argument on the create_column mutation allows you to specify which column to create the new one after. This argument is available in API versions 2023-07 and later. Check out our documentation for more info! In the following code sample, the new status column would be created after the country column. mutation{ create_column(board_id: 1234567890, title:"Work Status", description: "This is my work status column", column_type:status, after_column_id: "country") { id title description } }

We just added a new breaking change to API version 2023-10: The deprecated items field on the groups object will be removed and replaced with items_page in API version 2023-10 . Please see our previous announcement for more information about the items_page field.