Product updates

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

✨✨Hi everyone! Excited to announce that after much anticipation, changes made to the Hours field of a Date column will now be able to initiate our native “When a Column Changes,” “When any column changes,” “Every day if date has passed,” and “When Date is Set” trigger blocks. This feature has been highly requested for a while. Now, whenever a user makes a change to the time configuration within one of their Date columns, this will initiate these trigger blocks to run. Here is an example of such a change: Try it out and as always, give us any and all of your feedback. We want to know what you think!

✨ ✨ Hi everyone! Happy to announce that we have released a new API method items_by_multiple_column_values() that will allow you to retrieve your items using multiple column values from the same column. This has been a highly requested feature, and we’re very excited to share it with you all! This new method utilizes the same arguments and fields as the items_by_column_values() method. For more information, check out our API documentation on this method here. Here is an example query using this new method: query { items_by_multiple_column_values(board_id: 12345, column_id: "status15", column_values: ["Working on it", "In progress", "Incomplete"]){ id } } In this case, I am querying for items with multiple values within a single status column. The response should return a set of item IDs that contain those status values.  Definitely give this new method a try and let us know your thoughts! Next stop: filtering by multiple columns and their column values. Thanks!

Hey amazing community! I have three new features and changes to announce today 🔮 Additional rate limits for board and group duplication We added a new rate limit when you’re calling the duplicate_board and duplicate_group mutations: you can now call these mutations a maximum of 40 times in a minute. If an app exceeds this limit, it will receive a 429 HTTP status code. We’ve added this to our documentation in the Duplicate Board and Duplicate Group sections. Subscribe to our new changelogs! As you may have noticed, we are revamping our developer documentation. As part of this revamp, each documentation center now has a changelog that you can subscribe to! To get notified every time we push a new feature to our API or apps framework, subscribe to them via RSS here: API changelog API RSS feed Apps framework changelog Apps framework RSS feed New “is_verified” field for users You can use this field to check if a user has confirmed their email address. It will return true if a user has verified their email address, and false if not. Documentation here. Here’s an example query that uses this field: query { users { name email id is_verified } } That’s all for now!

✨✨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!

✨✨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~

✨✨Hi everyone! In case some of you weren’t aware, we wanted to dedicate a post to our new React components! Mainly, we released and updated four main components: the focus state on components, the alert banner, the button group, and the menu button. 1. The focus state on components This added feature allows you to “focus” on different options using your keyboard. For instance:  You can find the link to our style guide for this here. 2. The alert banner This added component gives you another option to present alerts and notifications. For example: You can find the link to our style guide for this here. 3. The button group This new component is great for switching between states or contents within a feature, as you have a collection of buttons to choose from. For example: You can find the link to our style guide for this here. 4. The menu button This new menu component allows you to use buttons for editing and other actions inside of your menus. For example: You can find the link to our style guide for this here. We hope you enjoy these, and happy building!

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 💬

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

✨✨Hi everyone! Jumping on here to announce that we recently released a few mutation methods for our Workspaces. These new methods include: add_users_to_workspace() delete_users_from_workspace() add_teams_to_workspace() delete_teams_from_workspace() As their names imply, these methods will allow you to add and remove users and teams from your workspaces. For adding user(s) to a workspace, you are able to not only send an array of user IDs to subscribe to the workspace, but also you are able to specify the kind of user subscription (i.e. whether the user is a regular subscriber to the workspace or an owner of the workspace). Here is an example query for add_users_to_workspace(): mutation { add_users_to_workspace (workspace_id: 20178755, user_ids: [105939, 105940, 105941], kind: subscriber) { id } } Excited to see how you all implement these in your workflows; happy building! –Helen

Our team will be doing scheduled maintenance on May 9th 2021 at 8am UTC (this sunday). The maintenance will last approximately one hour. During this time, developers will not be able to create or edit integration recipes, custom actions, custom triggers or fields in their apps. Existing recipes will also be in read-only mode. The rest of the monday.com platform will work as expected during this time. Update: you will also not be able to create new integration features during this time. Please note that this maintenance only applies to the editors in the developers section. You will still be able to add integration recipes to your boards and edit them, and recipes will continue to trigger during this time. Here’s a screenshot of the section that will be read-only during this time: If you have any questions, feel free to reply to this post!

✨ ✨Hi everyone! I hope all is well. Wanted to jump on here with a quick update. At this time, our appsupport@monday.com email is experiencing some technical issues. However, our team is working to resolve them in just a few days. We will let you know once it’s up and running again. For now, please send all your requests to support@monday.com, and they will be directed to our Developer Success team accordingly. Additionally, our other channels of communication remain open (i.e. posting on the community in the relevant FAQ sections). Thank you all for your patience and understanding!

✨✨Hi everyone! After much anticipation, you are now able to create new Status and Dropdown labels using our API! To do so, use the create_labels_if_missing boolean argument to create any missing labels in your Status and Dropdown columns. This argument will default to false, so if you don’t define it as true the missing labels will not get created and your API calls will fail. Because creating new labels changes a board’s structure, you must have the permissions to change board structure in order to successfully use this argument. Here is an example query using this argument: mutation { create_item (board_id: 12345678, item_name: "New item", column_values: "{\\"status\\" : \\"New Label\\"}", create_labels_if_missing: true) { id } } Currently, this parameter has been added to the following mutations: create_item() change_simple_column_value() change_column_value() change_multiple_column_values() create_subitem() Thanks everyone and happy building! -Helen

Hi everyone! I wanted to announce that our team has decided to rollback the recent API complexity limit change of 10X the per-minute rate every 10 minutes (i.e. 50 million every 10 minutes). As of today, our complexity limits are: 5 million per query 10 million per minute 100 million per 10 minutes We want to thank everyone who submitted their feedback and for communicating your experiences. Our team is here to listen to any and all of them. We will continue to review the way in which we let our users know of future product releases and updates. Thank you for your commitment to monday.com and your continued feedback! Warmly, Helen

✨✨Hi everyone! We’ve gotten a few questions about this, so I wanted to make a post about our IP ranges for devs who need to white-label any monday traffic. The IP addresses that POST addresses are sent from are 82.115.214.0/24, or 82.115.214.0 to 82.115.214.255. Here is our comprehensive article about this in our support portal: https://support.monday.com/hc/en-us/articles/360012300479-What-are-monday-com-public-IP-ranges-. Hope this helps, and let us know if you have any questions!

Hey everyone 🔮 We made some changes to our rate limiting mechanism to make it easier for apps to understand their limits and prevent abuse of our API. TLDR: Each individual query now has a complexity limit of 5M Most apps/users won’t notice a difference (but let us know if you do). How our rate limits work: a recap GraphQL rate limits are based on how much work you makes our servers do, measured in a unit called complexity. Each account and app has a specific complexity allowance that resets every minute. Trial accounts have a budget of 1M complexity every minute, while paid and developer accounts have a budget of 10M. New error messages When you run out of your complexity budget in a given minute, your app will now see a new error message that tells you how much budget you have left and when the limit resets: "message": "Complexity budget exhausted, query cost 1100010 budget remaining 999819 out of 1000000 reset in 19 seconds" Rate limit per query - 5M complexity We are enforcing a new limit of 5M complexity for each individual query. This is still quite a high limit, and you should be able to comfortably write queries that are under this limit using pagination and other best practices (more on that below). What should I do to prepare for this? We believe that very few users will be affected by these changes. However, you can ensure you don’t hit these limits by making your queries as efficient as possible. Follow these simple rules: Don’t ask for more than what you need. Every field in your query contributes to its cost, so only return the data that your app needs to do its job. Paginate, paginate, paginate. As far as possible, paginate through the returned data using the page and limit parameters. If you don’t add a limit or pagination to your query, we’ll assume you’re trying to return 1000 data points (which could blow up your query’s complexity). Reduce deeply nested fields. Each level of nesting in your query increases its complexity by 10x. Therefore, minimize the complexity of your query by ensuring you are returning the majority of your data in the first or second level of nesting. Here’s an example: # Inefficient (cost: 1011020) query { boards (ids:162169280) { groups { id items { id } } } } # Efficient (cost: 1220) query { boards (ids:162169280) { items (limit:100) { id group { id } } } } Have a question, comment, or feedback? Create a new thread from this topic by clicking the link icon 🔗 at the bottom of the post, and hitting “New Topic”:

Hey there, awesome developers! 🎩 Ever wanted to upload a file to our API using variables without using our SDK? You’re in the right place! Today, I wanted to share a code example you can use as a reference point to making File upload calls to monday.com, including variables. This can make it easier to make the actual API call, instead of using hard-coded values in the call itself. This also helps make escaping JSON easier. You can find the code example here with comments: Code example - uploading files with variables using Node In general, you can take the logic of the code example above, and apply it the programming language you are using. You will be sending a request that consists of 4 parts: Query: The actual API query you’d like to make. In this case, either upload a File to the Files column, or to the Updates section. Variables: Your GraphQL variables, where you can store either the Update ID to be used, or the Item ID and the File column ID to be referenced in the mutation. This is useful as it allows you to avoid an additional layer of escaping JSON; Map: This is the part of the request where you include the name of your variables.file request part. For example: var map = {“image”:”variables.file”} This allows us to use variables in the call, and to also include a different name for the file we upload, if necessary. Variables.file (has to match the Map name) This is where you are passing the actual file to be uploaded. To sum up, you will be making a multipart/form-data request here, which is somewhat different from making the usual “application/json” requests for Queries and Mutations. You can find some more examples of multipart/form-data requests and GraphQL below: Some more general info on using multipart/form-data with GraphQL multipart/form-data general info This code example is based on another example that Dipro made earlier, constructing the request using boundaries and creating a stream of the File to upload before making the API call: Uploading a file to monday.com without variables I hope this helps you make more efficient API calls when uploading files to monday.com 🙂 -Alex

✨✨Hi everyone! We wanted to announce that our API now supports date-time formatting in accordance with the ISO8601 standard. This change will mostly affect the created_at and updated_at fields, as well as times stored in the Time Tracking column. The following types have the created_at and updated_at fields (which will be in accordance with ISO8601 as of today): Updates Boards Users Assets Items One thing to keep in mind: the created_at field for board activity_logs will not be updated to the new standard. As always, let us know if you have any questions!

✨✨Hi everyone! We know that some of our users use Windows computers, so we decided it would be a good idea to release an official troubleshooting guide for our Quickstart guides on these machines. Taking the example of our Quickstart Integration recipe, follow each of the steps until you get to step 4. Instead of copy-pasting the given command in your command line prompt: Download the project from our GitHub library following these steps: Download the Quickstart code from this GitHub repo. Navigate to the directory where you downloaded the code Install the dependencies with npm install Run the development environment with npm run start Following these steps, you may run into the following error messages: Kill-port is not recognized: 'kill-port' is not recognized as an internal or external command, operable program or batch file. If you run into this error message, this means that the kill-port command isn’t available on your machine. To correct this, simply install the kill-port ability with the following command and you should be good to go: npm install --save kill-port. Learn more in this community post. Nodemon is not recognized: 'nodemon' is not recognized as an internal or external command, operable program or batch file. If you run into this error message, this means that, like the kill-port command, the nodemon command hasn’t been installed on your machine yet. You can correct this by running the following command, which should install nodemon globally on your machine: npm install -g nodemon. If you see an error message along the lines of: Node Sass does not yet support your current environment: Windows 64-bit with Unsupported runtime (88) you may just need to update your node version by first installing NVM, then run nvm install 10.16.3 to install this version of Node. Lastly, run nvm use 10.16.3 before running the npx command. Learn more in this community post. After resolving these errors, run the same command `npm run start` to start your server. Paste the outputted URL in the URL box from step 4 here: I hope this helps! Feel free to let us know if you run into any other errors when installing. -Helen

Earlier today, we released a huge milestone for our apps framework – versioning. Versioning gives app developers an infrastructure to add new features to their apps without disrupting existing users’ workflows. For a full breakdown of the feature, check out this article: App Versioning Wanted to flag a couple of benefits that I think y’all will appreciate: You can work on new drafts of your app (e.g., add new features) without worrying about current users You can automatically push updates to your app to your user base with a few clicks You can prevent breaking changes from being pushed by requiring users to update an app before using new features Have feedback? Post it below!

✨✨Hi everyone! We thought it would be a good idea to post the complexity weights for each kind of field: Scalar fields (string, etc) = 1 Objects (items, boards, etc) = 10 Mutations = 30,000 items_by_column_values query = 100,000 File uploads = 100,000 Limiting and specifying IDs At this time, IDs are considered before the limit argument. In case you have added 4 Board IDs to your query, but are using a limit of 3 boards, your complexity rate will be based on the number of IDs you are using, and not the limit. Complexity limit per query Currently, there is a 5,000,000 complexity rate limit per query. This means that if you do a single query to the API and the complexity is over 5,000,000, it will be considered as exceeding complexity and the API call will fail. We suggest using limits within your query, as well as specifying IDs, in ordr to reduce complexity in such cases. Complexity Rate refresh rate An important thing to keep in mind (and a question we often get) is that complexity rates are set for each minute, and not for each query. This means that, though the complexity of your query may not be very high, if you’re calling said query many times, this could also lead to a complexity limit error. To combat this, you can either implement pagination, limit the amount of data you’re querying/mutating, or reduce the nesting of your API call. For more info about complexity and rate limits, check out this section of our API documentation: https://monday.com/developers/v2#rate-limits-section. -Helen

We just released an open-source Figma template that contains a ton of example components for building apps to look like monday! Check it out here: monday.com UI KIt You can duplicate it and start using the examples in your apps immediately!

New feature alert! 🎩 I’m excited to announce that uploading files to monday.com has just become a bit simpler using our API, and even easier when using our SDK. Now, when making direct calls to our API, you can upload files in a more GraphQL-like way. With your query you can now include query variables alongside files! This is compared to before when you’d need to use inline variables in the query. Now, the following request to our API is possible: const query = mutation add_file($update_id:Int!, $file: File!) { add_file_to_update(update_id: $update_id, file: $file) { id } } ; const variables = { update_id: yourUpdateId, file: yourFile }; Here’s an example in Postman as well if you’d like to try this out: Send the request as form-data; Send a POST request to the special File endpoint: https://api.monday.com/v2/file Use the File type for the file; You can use Text inputs for other Keys, and Auto for content-type; In “variables”, you can include your Update ID, or Item + File column IDs. To add the File as a variable, you will need to add another Key to map the variable to another key. In the Map key, you declare the name of the variable, for example, “image”, and then set it as the variable.file. And you should get a result as follows: Always make sure to send your File upload requests with variables to the https://api.monday,com/v2/file Endpoint. Here’s a cURL example as well: curl --location --request POST 'https://api.monday.com/v2/file' \\ --header 'Authorization: yourSuperSecretApiKey' \\ --header 'Cookie: __cfduid=d0359804269ad2a2a33bc1bbbe9d6f18d1612880009' \\ --form 'query="mutation add_file($file: File!, $update_id: Int!) {add_file_to_update(update_id: $update_id, file: $file) {id}}"' \\ --form 'variables="{\\"update_id\\":920768626}"' \\ --form 'map="{\\"image\\":\\"variables.file\\"}"' \\ --form 'image=@"/Users/alexsavchuk/Downloads/300px-All_Right_Then,_Keep_Your_Secrets.jpg"' What about the SDK, you might ask? This has now become easier too 🙂 Developers using our SDK to make requests from View apps that are using seamless auth will now also enjoy seamless file uploads! monday.com will now translate any query into a multipart request IF it detects the request contains files. This means that if you’re adding files as variables, it will just work with zero extra code on your side 🙂 If you are making a direct call from the server-side using the monday.api method, the translation will not work. Instead, we recommend constructing your own HTTP request using a library of your choice.

✨✨Hi everyone, After much anticipation, we’ve released the ability to create dependencies within your List type custom field blocks! This will allow you to get a payload after a user makes a selection for your first field containing the Id of that selection. This way, when the user goes to make a selection in a second field, you can use this stored Id to load/call those dependent options. Here is how you would go about setting up and using this new feature: In the “Field Type Editor” of your Custom Entity, choose the “Automation config” to be of the “List” type. Insert your corresponding “Remote Options URL” (this URL returns the payload that contains the fields in your Custom Entity). For the dependencies, in your second custom field type (in this screenshot it’s “Second Option”), add in the field type that it’s dependent on-- the one the user chooses first: In your “Action Editor” custom block, list out both the first and second (i.e. dependent) options: In the action block of your recipe, configure the second option to be dependent on the first option: You can also return the boardId as a dependency. This is how that configuration would look: Field type editor: Action block selections: Hope this makes your lives a bit easier! Happy building~ -Helen

✨✨Hi everyone, Great news! We just updated our API to include the ability to update our Location column. To add or update a location in this column, include the longitude and latitude, as well as optionally the text to be displayed. These values are JSON data types, and should look something like this: JSON.stringify({ “lat” : “40.6892494” “lng” : “-74.0445004” “address” : “Giza Pyramid Complex” }); Or like this in JSON: “{"lat" : "40.6892494", "lng" : "-74.0445004", "address" : "Giza Pyramid Complex"}” To get the full update and details about this column, check out the Location column section in our API documentation here. -Helen