Product updates

We just added the move_subitem webhook that allows you to listen for when a subitem moves from one parent item to another. Check out our documentation to see the complete list of available event types!

We recently added the out_of_office field to the users object so you can easily check someone’s out-of-office status. The out_of_office field also supports the following fields to give you additional information about the user’s status: active disable_notifications end_date start_date type Take a look at our documentation for more info! 👀

We heard you loud and clear… 🔊 We just added 3 new query params for custom URLs that allow you to direct users to your app’s plans and pricing, how to use, and billing screens! Check out our docs to learn more about each one and find out how to build custom URLs 📄

App builders - this one is for you! We just added a new tab to the developer section that allows you to directly submit your app to the marketplace. It really is as simple as 1, 2, 3! Open your app’s management page. Click Publish to generate a shareable link. Complete the app submission form.

The position argument has also been deprecated for the update_group mutation. You can now use the group_attribute and new_value arguments to move the updated group before or after a specific group on the board. Check out our documentation to find all the details!

We’ve recently made changes to the create_group mutation and deprecated the position argument 💣 If you still want to specify the location of the new group on the board, you can use the recently released relative_to and position_relative_method arguments. Check out our documentation to read more about each of these new arguments and see them in action! mutation { create_group (board_id: 1234567890, group_name: "new group", relative_to: "test group", position_relative_method: before_at) { id } }

Due to popular demand, we recently added the ability to create columns with custom IDs! 🥳 To create a custom ID, you can now send the id argument in the create_column mutation. This is an optional argument, so you will still receive an auto-generated column ID if you don’t send it. When using the id argument, make sure the value you send meets the following requirements: [1-20] characters in length (inclusive) Only lowercase letters (a-z) and underscores (_) Must be unique - no other column on the board can have the same ID Can’t be null, blank, or an empty string If not, the mutation will fail, and the column will not be created. Check out all the details in our documentation! Happy creating 😎

I just released two new videos about workdoc apps. This one explains what workdoc apps are and the most common ways our customers use them: Intro to workdoc apps And this is a tutorial on how to build your first doc action: Build your first workdoc app We also have a new “monday app developer” Youtube channel! Check it out here: monday app developer - YouTube

Hey builders - check out this exciting opportunity 🛠️ We recently released the Doc Actions feature that enables developers to build apps for the workdocs product - monday.com’s powerful solution for creating, brainstorming, and collaborating on documents (read more about Doc Actions and its capabilities here!) As developers who are already building with monday, you have a unique opportunity to create an app that utilizes Doc Actions and enhances the experience of the workdocs product. Compatible apps submitted for review by May 31st, 2023, will be promoted under our marketplace’s Featured section. They will also be considered for publication on our social media channels and newsletters sent to monday customers. Take advantage of this opportunity to help expand monday.com’s workdocs and increase your app’s reach. We can’t wait to see the creative solutions you develop!

Hey y’all, my name is Dipro and I’m a Developer Advocate here at monday. I think I’ve spoken to many of you already – either over support tickets, through my webinars, or right here in the community 🙂 This month I’m surveying our developer community to understand what y’all think of the monday apps framework and development platform. The survey is here – the required questions will only take about 5 minutes or so. I’d love it if you could fill it out!  We’ll be using this feedback to inform our product roadmap and prioritize areas of improvement. Thank you! 🔮

Starting April 15th, 2023, we will deprecate connections from Windows Server 2012 R2, Windows 8.1, or earlier because they use weak ciphers. This update will not impact support for TLS 1.3. Check out this document to find out which systems this update impacts, how to know if you are affected, and which ciphers you can use!

We recently fixed a bug that prevented users from creating a subitem via the API if no subitems were ever made via the web. The bug fix first verifies that the board doesn’t already have a subitem column and that the user has the required permissions to edit the board structure. If so, the user can then create a board’s first subitem via the API!

We recently added two new webhook events: create_column and item_restored. You can now subscribe to these two events and listen for when a column is created or when an item is restored from the trash/archives 😃

We have some exciting news to share… If your app has a workspace template feature, users from all regions can now access it! 😎 Before, EU accounts could not access the workspace template feature of an app if it was in an account on a US server. With this update, EU accounts can now access all workspace template app features! This change is effective immediately, but please note that you must release a new minor version of your app and promote it to live before users see the impact!

You can now specify the documents you would like to return in a docs query using the object_ids argument. Please note that this is the same ID found in the URL and in the doc column values!

Please note that the item_name argument is now required for the create_subitem mutation. If you try to send the mutation without the argument, it will return an error.

We recently added the item_terminology field to the boards object! You can now retrieve the nickname for items on boards using this field. Please note that users can input a custom nickname or select one from a predefined list.

Starting Thursday, March 30th, 2023, we will implement sandboxing for all apps running in iframes (view apps)! These apps will be subject to additional security measures to help protect our users from XSS attacks by only allowing specific actions in the sandboxed environment. While we do not expect this update to break anything, we recommend testing all the flows in your app in the sandboxed environment just to be sure. You can do so by adding the _apps_sandbox=v1 query param to a monday URL. On June 28th, 2023, we will then implement the second part of sandboxing by limiting these apps’ actions and only allowing the following directives in our iframes: allow-forms: Allows the page to submit forms. The form will be displayed as normal, but submitting it will not trigger input validation, sending data to a web server, or closing a dialog if this keyword is not used. allow-downloads: Allows downloading files through an <a> or <area> element with the download attribute and through the navigation that leads to a file download. This works regardless of whether the user clicked on the link or JS code initiated it without user interaction. allow-presentation: Allows embedders to have control over whether an iframe can start a presentation session. allow-same-origin: The resource is treated as being from a special origin that always fails the same-origin policy (potentially preventing access to data storage/cookies and some JavaScript APIs) if this token is not used. allow-scripts: Allows the page to run scripts (but not create pop-up windows). This operation is not allowed if this keyword is not used. We again recommend testing your app in the sandboxed environment with the new restrictions to ensure nothing breaks. You can do so by adding the _apps_sandbox=v2 query param to a monday URL. If something breaks and there’s no workaround, please complete a support request so we can find a resolution. Keep your eyes out for more reminders as we get closer to implementing the second part of sandboxing!

We just released a new integration error handling mechanism that allows you to display descriptive errors when an integration fails! 🚨 This mechanism helps provide a seamless user experience and makes troubleshooting much easier for both you and your users. Our framework currently supports two different methods to communicate errors: severity codes and HTTP status codes. Both methods allow you to display text in the event of an error, so users can better understand what caused the error and prevent it from occurring again. Check out our error handling doc to see examples and read more about each method!

We are excited to announce that our API playground got a complete makeover! 🤯 This update has been years in the making, and it is finally here! The playground has a brand new, intuitive UI that provides an overall better user experience. We’ve shifted some of the buttons to reduce clutter and maximize platform real estate. We’ve also added tabs that allow you to run multiple sessions at once, history tracking that allows you to add specific calls to your favorites, and HTTP header support. Currently, you can only access the new API playground through the Developer’s Center, but we plan to update the public playground in the next few weeks. Check it out for yourself and have fun exploring all of the new features! 😎

Starting April 15th, 2023, we will deprecate connections from Windows Server 2012 R2, Windows 8.1, or earlier because they use weak ciphers. This update will not impact support for TLS 1.3. Check out this document to find out which systems this update impacts, how to know if you are affected, and which ciphers you can use!

We’re excited to announce 3 new get, set, and listen SDK methods that can help improve routing and navigation within your app! 🗺️ monday.listen("location"): used to listen to a URL location inside an app monday.get("location"): used to get a URL location inside an app monday.set("location"): used to set query params in an app’s URL Let’s say your board view app has three different pages. You can store the current page’s location in the URL using monday.set("location"). Now when a user bookmarks that page and reenters later, you can route them back to the same page as before. Please note that you can only use this for routing inside your app!

Our SDK now includes type definitions for each method! 😎 This support can help you distinguish between correct and incorrect code before running it, ultimately helping create a smoother developer experience. All you need to do is update to version 0.3.0 to take advantage of the new features. You can also find all of the definitions in the types/index.d.ts file in our SDK! We’re always looking to improve our features, so we welcome any contributions from the community ⚡

We recently fixed a bug that now allows you to clear a dropdown column by sending an empty array in one of the following mutations: mutation { change_multiple_column_values (item_id: 123456789, board_id: 987654321, column_values: "{\\"dropdown\\":{\\"ids\\":[]}}") { column_values (ids: dropdown) { id value } } } mutation { change_multiple_column_values (item_id: 123456789, board_id: 987654321, column_values: "{\\"dropdown\\":{\\"labels\\":[]}}") { column_values (ids: dropdown) { id value } } }

We recently expanded our support for subitems in activity log queries 😎 Now, when you query activity logs, the update_column_value and create_pulse events will contain the parent_board_id and parent_item_id properties. This change will not apply retroactively, but all queries moving forward will contain the new information!