Yes, it does! Our API is built on GraphQL and will give you a ton of flexibility for accessing and changing information in your monday.com account.

Why GraphQL?

You use monday.com to manage all sorts of information, so the API is built to be as flexible as the platform. It handles expressive queries to get exactly the information you need, when you need it. If you want to know more about GraphQL as a query language, check out graphql.org.

Documentation and testing

To make using our API easier, there is documentation explaining the queries and mutations you can run on your data. You can also test your queries in our GraphQL explorer. 

Authenticating with your API Token

Any request to our API must be accompanied by an API Token to verify who you are.

API for admins

Each admin on the account has their own API Token, so make sure to keep it safe. To generate your API Token: 

1. Log into your monday.com account.
2. Select your avatar in the top right corner.
3. Select the Administration tab.
4. Select Connections on the left side of the admin page.
5. From the dropdown, select Personal API token.
6. Select the Copy button to the right of the personal API Token. This is what you should be looking at:

API for non-admins

If you are not an admin of your monday.com account, you can get your API Tokens via the developers' section, following these steps: 

1. Log into your monday.com account.
2. Select your avatar in the top right corner.
3. Select Developers.
4. Select Developer and then My Access Tokens at the top. 
5. By selecting Show next to the API token, you'll then be able to copy it as well. 

You can use this API token to authenticate all your requests to our API, as well as in our testing environment. The token can be regenerated at any time, but note that this will cause the old one to expire. 

API tokens generated through OAuth

You can also generate a token for specific apps using the OAuth Authorization Flow. The permissions of these tokens are limited based on the authorization scopes of the app to which they are linked. For more information, check out our OAuth documentation.

API Token permissions

Each API Token is scoped to the permissions of the person it belongs to. 

For example, if you have read-only access to a certain board, your API Token will not be able to update any information on that board. 

Similarly, if you do not have access to a private board, any apps that use your API Token will not have access to that board either.  

Accessing our GraphQL API

You can test queries and mutations before implementing them in your application, using the query editor included directly in the platform. To use the API explorer, go to the API explorer.

Once you've opened the explorer page, enter your API Token in this field: 

After supplying your token, you will enter our testing environment. The left pane of the explorer is where you enter your query or mutation, and when you press Play at the top left, the right pane will contain your results. 

You can also select the Docs button in the top right to access our documentation directly from the explorer. To access our documentation outside the explorer, check out the API documentation.

Sending requests

Once you've tested your queries, you can send them directly from your application.

All requests to our server should be POST requests sent to api.monday.com/v2. 

Be sure to use the application/json content type, and pass your API key as an "Authorization" parameter in the headers:

{
    "Content-Type" : "application/json",
    "Authorization" : "mySuperSecretAPIKey"
}

The request body is where your query and variables are passed. It should look like this:

{ 
    "query" : "...",
    "variables" : {"myVariable" : "foo", "yourVariable" : "bar"}
}  

Postman Collection

A Postman collection includes examples of the most common API requests. You can use it to test sample requests with our API and generate code snippets to copy into your application. Take a look at the examples so you can test your own requests.

Why use the API?

Not sure whether you need to use the API or not? The API lets custom applications access the monday work OS, so you can connect your own scripts, integrations, and tools to your workflows. If that sounds like something you're interested in, then the API is for you.

You can use the API in many ways to supercharge your workflows. Here are some examples:

• Connecting to third-party data integrations
• Configuring no-code integration tools like Zapier to build custom data flows
• Importing and exporting data in batches
• Using the API as a data layer for custom monday apps to connect to monday

How to go further

The monday platform also contains tools to build applications that are embedded inside your workflows, such as app board views, integrations, and more.

If you need even more options to enhance your workflows, you can use the monday apps framework to create bespoke applications for specific needs inside your workspace. Learn more in our Apps Framework documentation and deep dive into our examples.

Rate limits

The API enforces limits to ensure high-quality service and optimal performance for all accounts. Learn more in the rate limits documentation.

Happy coding!

Now that you've got a basic understanding of sending requests to our API, go ahead and check out our API documentation. You can also play around with our testing environment!

And last but certainly not least, check out our quick start tutorials in different programming languages:

• API Quickstart Tutorial - Javascript
• API Quickstart Tutorial - PHP
• API Quickstart Tutorial - Python