We most certainly do! 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?

Our users use monday.com to manage all sorts of information, and we wanted to build an API that is as flexible as our platform. Therefore, we built an API that could handle 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, we have written documentation explaining the queries and mutations you can do to your data here. You can also test your queries in our GraphQL explorer here. 

 

Authenticating with your API Token

Any request to our API must be accompanied by an API Token, to let us know you're you. 😊

 

API for admins users

Each admin on the account has their own API Token -- make sure to keep this safe! To generate your API Token: 

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

 

API for non-admin users

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. Click on your avatar in the top right corner.
3. Select "Developers."
4. Click "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 regernated 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 user's API Token is scoped to the permissions of that user themselves. 

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

Similarly, if a user does not have access to a private board -- any apps that use the API Token will not have access to that board either. 

 

Accessing our GraphQL API

We know that our users like to test things out before implementing them, so we included a query editor directly in our platform! You can use this to try queries and mutations before implementing them in your application. To use the API explorer, go to this link.

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 click the "Docs" button in the top right to access our documentation directly from the explorer. To access our documentation outside the explorer, check out this link!

 

Sending requests

So, you've tested your queries and you're ready to send them directly from your application? Well, you've come to the right place. 😊

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"}
}  

 

A simple example in cURL

Putting all this together, we can use the following cURL command to get a user's name using the GraphQL API: 

curl -X "POST" -H "Content-Type:application/json" -H "Authorization:XXXXX" -d '{"query":"{me{name}}"}' 'https://api.monday.com/v2'

 

Limitations

The API rate limits are based on the complexity level, which is limited to 10,000,000 / minute per account. You can learn more about this here!

 

Happy coding!

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

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

 

 

 

If you have any questions, please reach out to our team right here. We’re available 24/7 and happy to help.