Guide to our old API (v1)

 

Note: This article is for our old API, which will be deprecated soon. Our new API is based on GraphQL and is great! Check out this article for a walkthrough. If you want to know about the differences between the two API versions, read this

We have two API tokens displayed in the Admin section under the API tab-- Personal API Token and Company API Token. This article explains how to use it. 👇

Two types of API token

We have two API tokens displayed in the Admin section under the API tab: Personal API Token and Company API Token.

api-token-screenie.png 

Company API Token

Your company API Token, is how you can communicate with all main boards of your account. Everyone in the company will have the same Company API Token, as this is the token to speak directly to your account. 

Personal API Token

Your Personal API Token, is how you can communicate with your personal Shareable boards and Private boards. This is a unique token, as everyone has different boards under these board types.

Developer Page

Just under the API Tokens, you will always find the link to our Developers page. As scary as that page looks to us non developers, it actually is an easy, almost mindless way to generate the API you need for the actions possible with your account.

The page is broken down by, Updates, Pulses, Boards etc., you then have the option to "Get", "Put", "Delete", or "Post"--luckily our amazing developers understand not everyone speaks code, so to the right of each action, you will find the description, "Get all the account's pulses", "Add a subscriber to the pulse" and more.

Let's say, for example, we want to update a Pulse's Attributes. All we need to do is fill in the information required on the developers page and click "Try It Out".

blobid1.png 

The ID, can be found in the URL when clicking into a pulse. The name, is the title of the pulse.

Once clicking "Try it out", I will get my results, meaning I will get feedback showing this request works or not. 

If i see the result "200" I am in luck, it was a success, if I get "401" something is wrong with the API and I have to try again. 

Once you receive the result "200" you can company the Request URL into your system! 

API limitations

Our API is currently limited according to the plan you have purchased.

Standard and Pro plans

The API daily limit is 60000/day

The API limit per minute is 300/minute

The API limit per second is 100/second. 

Enterprise plan

The API daily limit is 120000/day 

The API limit per minute is 600/minute

The API limit per second is 100/second

 

If you have any questions about this or anything else, reach out to us at customer success at support@monday.com :)