Product updates

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

Hello awesome dev community! It’s Alex from monday.com’s developer success team again. If you ever find yourself stuck with an API call that just doesn’t seem to be working, this is the right place to be. Today, I wanted to share some general guidelines on how you could troubleshoot an API call to monday.com, and the basic steps to take in order to isolate the behavior further. We’ll go through the following steps together: Troubleshooting an API call on the API playground; Troubleshooting an API call made as an HTTP request; Limitations you should keep in mind Where to get additional help, if all else fails How do I troubleshoot API calls? This guide goes through a few different ways you can troubleshoot your API calls. These are basic steps you can take into account if something doesn’t seem to be working. You can use this guide to figure out the best next course of action. Part 1: The API call does not work in the Developer Playground As a user of monday.com, you have access to a testing environment to play with the API without needing to build their own environment. You can access it by going to the Developers section, found in “My Profile”: You can then choose the Developer Playground in the top menu to enter your account’s API test environment: Here, you can test queries, as well as mutations to see what data each query returns without having to package it in an HTTP request. If your query works in the testing environment, then we know the issue is probably with how you’re sending data to the server. Feel free to scroll right ahead to part 2 🙂 Part 1a: Argument X on field Y has an invalid value. This error means that the server expects a certain type of value (such as a number or text string) but is receiving a different type. Check the data you are trying to pass for that field, and what the server expects (via our documentation). Here’s an example: Since we are sending an integer to a text column, which normally expects Strings, we get an innvalid value error. If we send the same value (3) formatted as a JSON string, that will work: Part 1b: Field X does not exist on Type Y You might be trying to change a value that doesn’t exist, or make a query that doesn’t exist. For example here’s a query that doesn’t work just yet, since the “subitem” argument for board_kind doesn’t exist: Please check the spelling of the fields in the query. Part 1c: Parse Error on X This means there’s an issue with the commas and brackets of the query. Make sure the brackets are balanced and there are commas between the fields of each query 🙂 For example, there is an extra right curly bracket in the query below: Part 1d: 500 Internal Server Error This is a generic error that could be caused by a number of issues with your query – it’s basically a catch-all error for all the other issues that can crop up. If you get an Internal Server Error, check the following: Do you happen to have extra commas or brackets in the query? Is there a chance you are trying to get a board that doesn’t exist? Could it be that your API call is attempting to get an item that doesn’t exist? Or perhaps there’s a chance your API call is querying for a column that doesn’t exist? Part 2: It works in the testing environment, but not in my application 😦 If the query works in the testing environment but is failing in your custom application, there are a few quick troubleshooting steps we can do to ensure you are sending the correct information. Part 2a: Is the query exactly the same as in the testing environment? Sometimes, things can go wrong by accident in the weirdest of places. Sometimes, the query is just not copypasted fully. If you are creating your query through code that dynamically populates a query in your application, it might make sense to first test the exact query you are planning to use in the testing environment. If this works, then we know the issue is in how your data is being sliced-and-diced to generate your final API call. Part 2b: Are you sending the request to the right place? All API requests are sent to our server as an HTTP request. HTTP requests are the basic protocol used for almost all, if not all interactions on the modern internet. Requests to our API must be POST requests (signifying they want to change data). This applies to both queries and mutations. Note: although GET works for some queries, POST is still the best-practice method for this. Sent to https://api.monday.com/v2 for queries and mutations, or the File endpoint if you are trying to upload a file - api.monday.com/v2/file Part 2c: Are you passing the correct headers? HTTP requests are made of two chunks of data – headers and a body. The header contains metadata about the request itself; it tells the server “Heads up! This is the kind of data I’m sending you.” The body is where the actual content of the request is. There are two headers, in particular, that are required to be sent with any API request. One is the “Authorization” header, which supplies the API key, and the other is “Content-Type”, which tells the server the format of the data in the body. Please make sure you are passing the following in as headers: { “Content-Type” : “application/json”, “Authorization” : “mySuperSecretAPIKey” } Part 2d: Is the request body formatted correctly? You will need to make sure you are passing the query correctly. In the Body of your HTTP request, you will need to declare that what you are sending is a “query”, and this applies to both queries (getting data) and mutations (changing data). You will just declare further that the query you are sending is a mutation later down the line. An example of a query to search your board’s items for column values in Postman: In case you are sending a mutation, that has to be included in the body of the API call: Part 2e: I’m still getting an error. Now what? If you’ve followed the above instructions and are still getting an error, there might be a problem with how your query is structured. You can check out the Errors section of our API documentation - perhaps that can help figure out what is going astray. Part 3: Things to be aware of: Part 3a: Unsupported column types: If your API call takes over a minute to process, you will be faced with a timeout. In those cases, try and see if you can reformat the call to be more lightweight - getting the same data in multiple calls via pagination, for example. Another thing to check is making sure that the user that generated your API token has access to the board you are attempting to query. If you receive an empty object as a response from a “boards” query, most likely there is something astray with the access permissions. Some column types are not supported by our API, or are supported to a limited extent. Here is a list that can help you as a reference point: Columns you cannot read or update via the API Progress tracking Auto number column Columns that you can read using a workaround Item ID column – you cannot get the data in the column, but you can check the ID of the item via the API; Last updated column – you can get the time an item was edited via the activity log queries; Creation log column – you can check the creation date of the item via the API; Formula column - you can read the formula configuration (using settings_str), and then calculate the formula values in your application code. Columns without write support TIME TRACKING:. You cannot edit the data, or start/stop the timer. Part 3b: Items_by_column_values limitations: You can not query for null values just yet; It is not possible to query multiple columns at the same time; It is not possible to query for multiple values (for example, array of user IDs to search for in a People column); The items_by_column_values query does not support every single column type. Generally, if a column can contain multiple values (dropdown, people, tags), it cannot be filtered. To populate the Numbers column with a “0” value, you might need to format your column values as a String, and not as an integer. You can also take a look at the Errors section in our documentation to find more info on the errors our API might throw, as well as some general steps you can take to troubleshoot. Part 3c: List dimension mismatch on variable $theboardid and argument ids (Int! / [Int]) At the time, the board IDs field will expect an array/list of Ids. If you are sending a single ID, you’ll need to declare your variable as an array. Here are 2 examples that can illustrate the point a little further: This is an example of a query that won’t work: query ($boardId:Int) { boards (ids:$boardId) { items(ids:162169283) { column_values(ids:"time_tracking") { value } } } } This query will work instead! Notice how the board ID variable is declared as an array of integers with [Int]: query ($boardId:[Int]) { boards (ids:$boardId) { items(ids:162169283) { column_values(ids:"time_tracking") { value } } } } Part 4: Getting additional help If the above steps haven’t solved the issue, please feel free to reach out to us in the community or by using our appsupport@monday.com inbox - we’d be happy to help!

Follow this section! It’s a place for the monday dev success team to put feature announcements, helpful examples, and tips. Here is a list of threads that might be helpful for folks designing and building monday apps. This document is a work in progress, and we’ll keep adding to it as y’all share your tips and tricks. Getting started with the basics Here’s some basic documentation to get you started building with the monday apps framework. Intro to monday apps Quickstart guides Code examples API Documentation API webinar Code examples in different languages Here are some code samples for building with specific technologies. Python: Python API integration help Python Code Example: Importing existing Zendesk tickets using the API Python Quickstart Tutorial Moncli - Monday.com client for Python - Third-party library Python library for v2 api on github - Third-party library cURL: cURL Examples for API v2 Uploading a file with cURL NodeJS: Node.js mutation example using Axios Node.js Change multiple column values Accessing and returning data from monday API v2 with Node.js Challenge with node Webhook PHP: POST request using PHP How to validate a Monday.com Webhook in PHP A Basic PHP Webhook Example C#: How to use add_file_to_column in VB.NET (API Call) Basic C# API v2 Example How monday.com works – the nitty gritty Here are some threads that answer common FAQs that developers have. How to upload a file via the API Where to find board, item, and column IDs Differences between client, account, and user IDs Error types thrown How to publish a build Common pitfalls and errors Here’s a list of common errors that developers often run into: Full list of errors GraphQL parsing errors: “-” parsing error Escaping quotations CORS policies File uploads sessionToken usage Unauthorized user Subitem querying limitations Dynamic mapping troubleshooting PowerApps and GraphQL

Hey everyone, Alex here from the Developer Success team! I hope your projects are running smoothly ✨ Ever wanted to make a custom API call inside Zapier? Well, I wanted to share a quick guide with you today that explores the 2 following topics: How to run a custom API query to monday.com using Zapier; How to use that query to get Integration column data (using SalesForce integration column); As you might be aware, currently, our Zapier integration doesn’t allow you to get integration column values. You might be thinking “the What? Column value?” and I’d love to shed a bit more light on this. So… what is the integration column? The Integration Column is a column type that is added for some of the native integrations that monday.com offers, usually for those that are able to sync future changs from the target platform. For example: This column stores information about the object from your Target platform that was created as part of an integration. This helps the platforms communicate to the correct points of data quickly, as there is a match of a monday.com Item to the ID from the other platform. In the screenshot above, it stores data about the Trello card that led to an item being created on your board. Pretty neat! Got it! So how do we get those neat values then? There is a way to get the Integration column data, and you can use the Custom Request and Formatter Modules to get the values you are looking for 🙂 So let’s get started! How to make an API call on Zapier? First, we’ll need to figure out how to make an APi query to monday.com by using Zapier. We can use the Custom Request module for this. You’ll need to make sure it is set up the following way: POST as the method; https://api.monday.com/v2 as the URL; Headers should include: Authorization: [Paste in your API key here]; Content-Type: application/json; The Data field is where you’ll insert your API request: Here is the query that I’ve used in the Data field. You’ll need to make sure your Integration column ID matches the column ID on the platform {“query”:“{boards (ids:BoardId){items (ids:ItemId) {name column_values(ids:"salesforce_object") { value text}}}}”} If you have a previous step in Zapier that relates to monday.com, you can also use the Board and Item ID values from that step. In my screenshot example, the first Zap would trigger when an update on monday.com board is posted, and I could then use those IDs to query that specific item’s integration column. Making those values usable - How to apply Formatter to the output. The result is a JSON string, and we’ll need to take an extra step here to get the SalesForce object ID that we can work with. We can get the value we are looking for by using Zapier Formatter. Now, choose the Formatter Module, then the Text Action: In the next step, we’re going to want to Split text. This will allow us to use the overall output of the API request to get meaningful chunks of data: The input should reflect the data returned by the API Query from earlier: As your Separator, use quotes: Then, use All (as Separate Fields) as the separation option: The final output should provide you with the following set of items: You’ll then be able to use those items in your Zap’s next steps: Good luck! I hope this helps you if you’re just starting out with Zapier, or already a heavy user and looking to expand on the options we currently provide.

✨✨Hey everyone! We realize that a lot of our users don’t know about our Storage API, so I wanted to explain a bit more about it here. Our Storage API is an offering we have for our app developers. It gives you managed, key-value storage on our monday servers without having to launch, manage, and secure your own databases. Not only is it a really easy way to add persistent storage in your apps, but also it’s completely free to use! One thing to keep in mind: if you have a payload that’s bigger than 4MB, you can break it up and store it in multiple keys.   Feel free to check out the Github SDK readme for more information. And shoutout to our dev @danielmittelman for his help on this! -Helen

✨✨✨Hello everyone, After seeing some questions in the community about this topic, we just wanted to clarify our run URL retry policies. Your run URLs will be re-tried every minute for 30 minutes should it receive anything other than a 200 status code. You can find out more in both our Custom Actions article, as well as our Authorization article. Thanks! -Helen

Hey hey, awesome builders and API users! 🌟 It’s Alex from the monday.com team and I wanted to share a quick and awesome update here. We are happy to announce a new addition to our API, which was a highly requested feature previously. Now, you are able to sort the boards query results using the order_by argument. The sorting options are: Board creation date - order_by: created_at Last activity on the board - order_by: used_at Getting the latest data from your monday.com boards should be a little easier now 🙂 You can find more info on this in our documentation. Here are both queries for your conveninennce: Used most recently: query { boards (order_by: used_at) { id name } } Created most recently query { boards (order_by: created_at) { id name } }

We’re doing a developer Q&A session today at 16:00 UTC/11:00 EST. Sign up here! I’ll be there to answer your toughest monday apps questions. If I don’t know the answer, you’ll win some swag! 🔮 If you can’t make today’s session, there will be another session next week at the same time. See you there 👻

Yep, you heard us! We just released 8 React components that you can use in your monday apps! Now you can make your custom app look like monday, without having to rebuild all the UI elements from scratch. Can I contribute my own components? You sure can! Read our Contributing Guidelines to learn how you can add your own components to the monday library. What’s next? We’re going to release more components later in the year. Which ones would you like to see? How do I access them? Head to this Github repo to learn more: monday UI React Core You can also access them directly from our apps documentation: Included components: Button Icon Text field Search box Loader Tooltip Link Linear progress bar Heads up, @kaminskypavel @community-experts 😊

Hey everyone! 🚀 You can now use strings when sending data to a particular column instead of formatting it as a JSON. This is particularly useful when updating simple columns such as text or status columns. You can find all the documentation for this on our developer page. Using a status column as an example, you would now be able to use either "Done" or "0" as your value for updating the status. If you still prefer to send it as a JSON string, those mutations remain unchanged: "{\\"label\\":\\"Done\\"}" One additional thing to note is you can mix these! This means your query can use both simple values and JSON values. Here’s how it would look when used in a change column value mutation: mutation { change_simple_column_value (board_id: xxxxxx, item_id: xxxxx, column_id: "status", value: "Done") { id } } And the create item mutation: mutation { create_item(board_id: xxxxxx, item_name: "My Item", column_values: "{\\"status\\": \\"Done\\" }") { id } } You will mainly be using this new feature in 2 scenarios - when updating the value of an item using the change_column_value mutation, or when creating a new item by using the create_item mutation and setting its values on creation. The following columns currently support being updated with a simple column value: Date column Dropdown column Email column Link column Long text column Number column People column Phone column Status column Text column If you try and send a simple string to a column which does not currently support it, the server will reply with a message explaining the problem: “error_message”: “column type CountryColumn is not supporting changing the column value with simple column value, please check our API documentation for the correct data structure for this column. https://monday.com/developers/v2#column-values-section”, Hope this is useful for everyone! If you have any questions let us know below. -Daniel

Hey app builders! We release great new functionality to the app framework and I wanted to share with you about it so you can start building some more amazing stuff! Item View: This new capability of the monday Apps Framework gives the ability to create new item views, which will be placed next to “Updates”, “Info Boxes” and “Activity Log” tab: User can add new item views with help of “Add view” button. This button will appear if there is at least one item view in the account, and in the future will appear for all users. Once an item view was added it will be added to all of the items in the board. Building an Item view is the same as building board views and dashboard widget but it gets a different context of a specific Item view: // Item view context { "boardId" : 12345, "itemId" : 123456 } You can learn about how to build your item view here: https://monday.com/developers/apps/quickstart-view Workspace Template: Workspace Templates allows you to create a template out of a workspace in your account. After installing your app, users can add the template from the template center to their account: You can add all of your app feature to the template and they will be duplicated as part of the template. It’s a great way to package all of your app features to a monday workflow to make it easier to start using your app features and to show best practices on how to set it up. All of the settings of the views, configuration of the integration recipes will be duplicated as well. It can have a pretty extend configuration, which includes the solution “on boarding” experience after user uses it from the template store. You can configure which workspace will become a template, which board and view of this workspace user will be landed after the duplication process, and even the view mode for it (vertical split or fullscreen). You can also add all of the information that will appear in the template center so users can easily understand when and how to use this template. Item Mapping: This is an enhancement to our integration recipes. Item mapping allow you to sync external fields of an external entity to a monday item and all of it’s columns. For example sync a lead in salesforce with a monday item. You can allow the user that is adding your integration recipe to the board, to map the field that he cares about to the his columns. That way you can create one recipe that each user can use differently and adjust it to his boards and data. For example map the fields form a zendesk ticket to an item: And after adding this recipe the user can map the field: In order to use item mapping you need to create a new field type - dynamic mapping. When you will add this field to a recipe sentence, it will show the user the mapping screen between the fields. You need to provide the field definition url that will return a list of field that are supported in the external service and their primitive type in order to show the relevant options to the user that is configuring the integration. You can learn how to set it up here: https://monday.com/developers/apps/dynamic-mapping Good luck and looking to hear some feedback and questions!

Hey everyone! Hope everyone is having an awesome Friday in the community. I wanted to make a quick post on a recent change regarding API queries in case anyone runs into this. Previously we were supporting hitting custom URLs (based on your slug) for querying the v2 of the API. This was a bit of an obscure feature that a few users used which meant you could point at your account URL. For example: https://dsilva.monday.com/v2/ This will no longer work. Instead you will want to use the direct link to query the API: https://api.monday.com/v2/ If you’re already using the API url, you don’t have to worry about anything. Hope this helps - as always if there’s any questions / comments please let us know. Stay awesome everyone!

Hey amazing community! We released three highly requested features recently and I wanted to give you a heads up about them. Item Views Item views let you create apps that are displayed in an item’s “Updates” pane. The view behaves exactly the same as a board view or widget, only it’s connected to a single item. Check it out in our documentation here! Workspace Templates These let you bundle a set of templates with your app. Super useful if you want your users to have a specific board structure and reduce the amount of app configuration. Documentation is coming soon, but until then you can explore the feature by adding it to your app: Dynamic Mapping and Custom Entities This is also a highly requested feature. You can now create custom entities in your app that map to objects in other tools (or monday.com). You can also specify dependencies for the configuration! We’ll link to more documentation in the next week or so, but here’s a brief explanation of how it works. When a user tries to configure the mapping field, the monday Apps server will send a request to your “Field Definitions URL”. Your server should then respond with a list of field definitions, which your users can use to map item data to. Here’s an example function that returns the field definitions: async function getRemoteFieldDefs(req, res) { return res.status(200).send([ { id: ‘name’, title: ‘Name’, outboundType: ‘text’, inboundTypes: [‘text’] }, { id: ‘desc’, title: ‘Description’, outboundType: ‘text’, inboundTypes: [‘empty_value’, ‘text’, ‘text_array’] }, { id: ‘dueDate’, title: ‘Due Date’, outboundType: ‘date’, inboundTypes: [‘empty_value’, ‘date’, ‘date_time’] }, { id: ‘creationDate’, title: ‘CreateDate’, outboundType: ‘date_time’, inboundTypes: [‘date’, ‘date_time’] }, ]); } You can already explore this by adding a custom field to your app:

Today we opened a few subcategories for our developer’s section to make it a one-stop shop for all things builders. What does this mean for me? You can help us with this transition in a few ways: Go into the new API Feature Requests category and vote for all the features you would like to see added. Voting on a feature will give us visibility into what features are highly requested so we can adjust our product roadmap. If you’ve commented on a feature request, please add a vote so we can track it more easily 🙂 If you have existing topics in the community, please move it to the relevant category if you can! Our team will also move topics to the subcategories in the coming weeks. If you’re opening a new topic, please add it to the relevant subcategory. If your topic was already moved by a moderator, you’re good to go! What categories did we add? We added a few subcategories and moved existing topics into them. We will add new subcategories as our developer’s community grows! We added subcategories for specific topics: monday Apps: for questions and feedback around the monday Apps Framework. This was originally a separate category, but we included it in the Developer’s section for more visibility. API Feature Requests: for any feedback on our GraphQL API. Vote for the features you want to see! API FAQs: for any questions regarding our GraphQL API. Have feedback? If you have any ideas for more categories, or need any clarifications, you can reply to this thread.

We’re super excited to update you that the monday Apps Framework is now released to beta! You can open it by clicking on your avatar inside your monday.com account, and then clicking on monday.labs and activating ‘monday Apps’. Once it’s activated, click again on your avatar and on ‘Developers’ to start building. The monday Apps Framework gives developers the ability to build custom board views and widgets, with automations and integrations coming soon! The apps you’ll build now will be for use inside your own account. The next phase will allow you to share your app with specific accounts and eventually, the entire monday user base through the apps marketplace. Information and documentation Check out this documentation for guides on how to get started and for a quick overview, check out our overview page. Our technical support team will be answering questions about the monday Apps Framework, right here 🙂 We can’t wait to see what you’ll build! The monday Apps team @dipro @Ben @Talh-monday.com

Hey there, Community! We just released 3 tutorials in our most popular programming languages! These articles go through the basics of our GraphQL API and are great for anyone just starting out. Each tutorial is aimed at folks with basic familiarity of each programming language. PHP Quickstart Javascript Quickstart Python Quickstart If you have any questions, feel free to open a thread in the community about it! Happy coding! Dipro 🔮

Hey community! We just released the first set of monday apps! Check out the full announcement here: Releasing our first monday apps! Cheers, Dipro 🔮

Hey community! 🔮 You can now access files that are on your board via our API, and also upload them. Here’s the documentation. Moderator Note: Check out the following announcement for examples that upload a file from the client-side: Announcement: Uploading files to monday.com has just become easier :) Reading Files using the API The assets field represents a file that is uploaded to monday.com. You can query the title of the file, the URL, and also generate a public URL that can be used to download the file. Learn more here. Uploading Files using the API Our API also supports uploading files to a file column or update. To do this, you need to send your data as a multipart request (Content-Type: multipart/form-data) with the file in a variable. Here’s more info. Do note that we have a separate endpoint for files (api.monday.com/v2/file). This endpoint has a higher size limit for requests (20MB, which will be increased to 500MB in the coming weeks). An example query: mutation ($file: File!) { add_file_to_column (file: $file, item_id: 256180125, column_id: "files") { id } } Here’s what such a request would look like in Postman: And here’s what that would look like in cURL: curl \\ -F query='mutation ($file: File!) { add_file_to_column(file: $file, item_id: 118607269, column_id: "files") { id } }'\\ -F variables[file]=@/Users/diprobhowmik/screenshots/image.png\\ -H "Authorization: APIKEYHERE" \\ https://api.monday.com/v2/file

Hey y’all! 🔮 I’ve been working with some clients recently who wanted to come up with custom Google Sheets integrations. To give them a taste of our API, I came up with a quick and dirty script to show them how they would send data from Google Sheets to text columns in monday.com. This example is for developers who have some experience with Google’s scripting platform and may be too technical (or bare bones) for non-developers. Description The example below will connect a Google Sheet to a monday.com board, such that every time an item is changed in Google Sheets, the data will update in monday.com. This is a super quick example, so treat this as a jumping-off point for more complicated integrations! Setting up the example To start, you’ll want a Google Sheet with a header row: Then, create a board that has a text column that corresponds to each column in the Google Sheet: Next, you will need to install this Google Script as an add-on to your Google Sheet. You may need to consult the Google Scripts API reference for more information on adding the script to your Google Sheet. Finally, you’ll need to change some variables to correspond to your environment. Add your API key to line 2, change the board ID on line 5, and update the array on line 8. Enjoy!

I just had a great conversation with one of our clients and realized that it would be helpful to have a guide on the structure of the data returned by our API. While each query will return data in a slightly different way, here’s a general guide for understanding response data. Fact: It’s easier when you use a library 😁 Before we dive in, I’d suggest everyone use a JSON parsing library to make the data returned more manageable. There are tons of libraries out there including JSON.NET, Python and JavaScript’s native json libraries, and Java’s Json API. Check out this page for a library in the language of your choice: www.json.org Expressions to access objects Here are some expressions you can use to access objects and fields returned by your query. data : Parent object that holds all the data in the query. This is returned for all successful queries. data.items : List that contains objects that each represent an item. data.items[0] : Access the first item in the list of items (Object) data.items[0].name : The name of the first item (String) data.items[0].id : The ID of the first item. data.items[0].group : Object that represents the group that this item is in. data.items[0].group.name : The name of the group of the first item (String). Example data Here is some data that corresponds to the expressions above: { "data": { "items": [ { "name": "Here's an item", "id": "161366694", "group": { "id": "new_group", "title": "This is a group" } }, { "name": "And this one is also an item", "id": "161366701", "group": { "id": "new_group", "title": "This is a group" } }, { "name": "Guess what this is? A item", "id": "161366747", "group": { "id": "new_group", "title": "This is a group" } }, { "name": "A pulse can be a task", "id": "161366844", "group": { "id": "topics", "title": "Here's another group" } }, { "name": "Or a project", "id": "160540651", "group": { "id": "topics", "title": "Here's another group" } } ] }, "account_id": 1825528 } Example query Here is a query that will return the data above. query { items { name id group { id title } } }