Skip to main content
  • 289 Product updates

[RELEASED] `parent_item` Field When Querying Subitems

✨✨Hi everyone, I’m so pleased to announce that we now have a parent_item field for our subitems! As many of you know, before this addition you could query your subitem column values and you could query the subitem column in your parent items to see your subitem IDs, but there was no direct link between the two. In order to match the relevant subitem column values with the correct parent item them, this required a manual searching mechanism created by individual developers to match subitem IDs together. However, with the addition of this new parent_item field, you will be able to query your subitem column values and also be able to see the relevant parent item information for this subitem! Here is an example of how to use this field: query { boards(ids: 'YOUR_SUBITEM_BOARD_ID'){ items{ // all of the subitems on your subitem board id // your subitem IDs parent_item { id // the parent item IDs for each subitem column_values { // the column values of your parent items id value } } } } } Keep in mind that because querying subitems currently follows the same structure as querying parent items (i.e. you need to first find your subitem board ID, then use that subitem board ID to query your subitems normally), if you use the parent_item field on a parent item, the result will be null. Check out our updated API documentation on this method here. We hope this aids in your subitem queries. As always, let us know your thoughts on this new field. Happy building!

[RELEASED] New webhook types for sub-item events!

Exciting news! We’re happy to announce a highly requested feature is now available. You’ve heard of webhooks on main items, but get ready for webhooks on sub-items! ⚡ Sub-item webhooks include the same events as the main item webhooks: When a sub-item is created; When any sub-item column changes; When a sub-item name changes; When an update is posted in sub-items; When a specific sub-item column changes; When a sub-item Status changes; You can add those recipes from within our Integration Center by using the Webhooks Integration: For recipes that support sub-items, you’ll be able to select a column from the sub-item level: You will receive a payload like this, which is identical to the main item’s payload. It will include the subhttps://community.monday.com/c/developers/dev-guides/70-item board ID, which you can use to distinguish between Main items and Sub-items. Currently, the event type will also be the same as for main items. You can include a query param for your webhook URL when creating webhooks for sub-item events in order to differentiate between updates to main items and subitems. For example, if my base webhook URL is https://alexscoolwebhook.com/, I can add /?subitemCreate=true to the end of the URL to get the following result: https://alexscoolwebhook.com/?subitemCreate=true You will then see the output with this query param included: To create webhooks for sub-item events via the API, use the following sub-item webhook event types: change_subitem_column_value - equivalent of “When any sub-item column changes” create_subitem; create_subitem_update; change_subitem_name; Note: At this time, it is not possible to use the API to create a webhook for Sub-item Status column changes, or for a specific Sub-item column change. We recommend creating a “change_subitem_column_value” webhook, and check the column ID that was updated. In your API call, use the Main Board ID. For example: mutation { create_webhook (board_id: 1544542904, url:"yourURL/?yourQueryParam", event: change_subitem_column_value) { id board_id } } Here’s a cURL example too: ​​curl --location --request POST 'https://api.monday.com/v2' \\ --header 'Authorization: yourApiKey' \\ --header 'Content-Type: application/json' \\ --data-raw '{"query":"mutation { create_webhook (board_id: mainBoardId, url: \\"yourWebhookUrl\\", event: change_subitem_column_value) { id board_id}}"}' I hope this helps building more complex workflows with sub-items 🙂 -Alex

[RELEASED] New Features: Apps Feedback Link, Searching for Apps by Devs, "Create an Item with Mapping and Link" Action Block, and Admin Permissions for API Tokens

✨✨Hi everyone! We recently released some new features, so I wanted to post an announcement introducing them. In total, we have four new features that I’m so excited to share with everyone. 1. We have a new feedback link for your apps! This will allow you to collect direct feedback from your user base via a link you provide. The link can be to a monday.com form, a Zendesk link or anything you’d like. Here is where you can input your feedback link: On the user end, they should see a little “Feedback” button at the top of their view apps: Here it is for Board Views: Here it is for Item Card Views: Here it is for Dashboard Widgets: Please keep in mind this feature is currently only available for view apps, not integrations! 2. We’ve also added the ability to search for apps by developer names (your names)! This should increase the searchability of your apps, so that users can now not only find your app by its name, but also by your name as well. This new feature should also increase the discoverability of the newer apps that you develop. Try it out! 3. There’s a new built-in action block “Create an item with mapping and link” that will allow you to create an item with mapping in a different board (Board B) and link that newly created item to an existing item on the current board (Board A). Here is a video of how the feature would work: 4. Lastly, there’s a new admin permission setting that can determine who is able to generate API tokens. Previously, all admin and member users were able to generate API tokens. With this new permission, admin users are able to choose if “No one”, “Only admins”, or “Anyone” would be able to generate API tokens. Remember, currently only member users are able to generate API tokens (other than admin users), so this “Anyone” would only apply to member and admin users! One thing to note about this new permission is, should a user reach out to asking why they’re suddenly no longer able to utilize their API tokens, I would ask them first if their admin user had changed this permission! There's a lot of new features to digest, so feel free to ask us if you have any questions!

New SDK Methods for Opening & Uploading Files

✨✨Hi everyone! Wanted to quickly jump on and announce our two new monday.execute() methods in our SDK. What are these new methods? You now have the ability to open existing files on a board using the monday.execute("openFilesDialog", ...) method. Additionally, you’re able to trigger a local file upload pop-up window in your app using the monday.execute("triggerFilesUpload", ...) method. Example app We created a very simple example app showing you how these two methods will work. Here is what users will see in the UI of this example app: We built this example app by modifying the App.js file in our Quickstart React code. Here is a screenshot of our modified file: You can see that in this example, we inputted the relevant IDs for these two methods manually. You can also, of course, include other SDK methods that will return the relevant IDs, depending on what the user has selected on their boards. Things to keep in mind 1. The monday.execute("triggerFilesUpload", ...) method will not work in the app preview section. This is something our developers are aware of and are working to address. For now, if you add your view app to an item, board, or dashboard, the feature will work as expected. 2. These methods will not work across boards. You must be sure that the files you are looking to open are located on the board that’s currently open. Same thing applies to uploading a file: the file must be uploaded to the board that’s currently open. We are so excited for you to start using these methods! Feel free to navigate to our SDK page here for more information. As always, let us know if you have any questions. Happy building~

Update on our processes in the Developers' Community

Hey amazing dev community! Dipro from the monday.com Dev Success team here 🔮 I wanted to post a quick update about some changes that we have made to how posts are managed in the community, and give you a sneak peek into what’s coming next. If you’re a regular, you’ve already seen these changes in action. This post is to document what we’re doing differently now. Changes to our community processes 1. Subscribe to the Announcements and Guides section We’re adding new features (and guides on how to use them) all the time. I recommend you subscribe to the “Announcements and Guides” section so you get notified the moment we add something new. To subscribe, click the bell icon in the top right corner and select “Watching first post”. This setting will notify you when we announce a new feature or documentation! 2. You can now mark posts in the FAQ sections as solved! When another community member answers a thread with an answer to your original question, you can mark that answer as a solution. This lets other users with the same question know how to fix a specific issue. The monday.com team will also mark posts as solved if we decide that the question has been answered. 3. Topics will be closed automatically, but you can create a follow-up To ensure additional questions and follow-ups don’t get lost in a long thread, solved topics will be automatically closed 7 days after the last reply. This does not apply to topics that don’t have a solution yet. When a topic is closed, you cannot add additional replies to it. However, you can open a follow-up topic. 4. Creating follow-up topics Do you have a follow-up question about a topic that was already closed? You can create a follow-up topic by following these steps: Click the link icon at the bottom of the post you want to follow-up on In the dialog box, click “New topic” The “New topic” pane will open with your follow-up topic already inserted. A link to your follow-up will be listed at the bottom of the original post, so that folks looking at the original will know the conversation continues somewhere else. What’s next? In the next month or two, we’ll be releasing two changes that we hope will improve your ability to keep up-to-date with what’s going on in the monday.com community. An overhaul to our developer documentation (stay tuned 😉) A more integrated changelog in our documentation. We want to notify our developer community about new features in our APIs and apps framework without needing to search through unrelated topics. Questions? Have any questions or feedback? We’d love to hear it! Open a follow-up topic so we can continue the discussion 💬

Upcoming maintenances on May 23 and May 30

Hey community! Wanted to give you a heads up about two upcoming maintenances that will affect integration apps and custom recipes. Have a follow-up question about this announcement or any others? Click the 🔗 link icon below this post and select “New topic”: Maintenance 1: Sunday May 23rd at 7:15am UTC (15 minutes) A routine maintenance for our custom recipes and monday apps infrastructure. It will last 15 minutes. During this 15-minute period: Custom recipes and monday apps recipes will be delayed Custom recipes and monday apps automations will not be visible in the automations/integrations center It won’t be possible to create new custom / monday apps automations After the maintenance is over, any automations that were supposed to run will execute. Therefore, you should expect any automations in this window to be delayed by 15 minutes. Maintenance 2: Sunday May 30th at 8:00AM UTC (1 hour) A routine maintenance affecting monday apps developers. If you are a monday.com user and don’t build monday apps, this won’t affect you. During the 1-hour maintenance: Developers cannot create new integration recipes in the Feature Editor Developers cannot update or delete integration recipes in the Feature Editor Developers cannot create new integration features in the Feature Editor Developers cannot promote any app drafts with integration features to live. Have any questions? Create a new topic