# Postman

[Postman](https://www.getpostman.com) is the go-to tool for many developers exploring the capabilities of Internet APIs. The Cronofy API is fully compatible with Postman so you can get started really quickly and start to learn how our API works.

## 1. Get your Application credentials from the Cronofy Developer Dashboard
If you don't have an Application yet [create one here](https://app.cronofy.com/oauth/applications/new).

When setting up your Application, add the URL of your application in the URL box. For testing purposes, you can also use your localhost here.

![](/developers/getting-started/postman/application-setup-page.2f2b2b28792bebfaa45555d6cd1a13f5cdadc974b763b10a45589005695a6547.png)
Then, navigate to the **Settings** tab to find your `client_id` and `client_secret`.

Before you can make any API calls, you will also need to authorize access to your calendar.

You can either do this by clicking the **Connect a calendar for your account** button to get connected or in step 3, when you generate an **access token**.

![](/developers/getting-started/postman/connect-a-calendar-to%20your-account-button.c7613d27b5ff6aea82f6013b2320cf28fb60fe6c0d6fe0e4dbb88b81cb8b605c.png)
## 2. Download the Cronofy Postman Collection
In the **Settings** tab you'll see a **Run In Postman** button that will allow you to download the collection.

Altenatively download it here by clicking the following button.

[Run in Postman](https://www.postman.com/run-collection/52437361-857a627d-514b-4a1c-864b-9b39f690bb32)
Open Postman and create a `Cronofy API` Environment ([how to create an Environment in Postman](https://learning.postman.com/docs/sending-requests/variables/managing-environments)). Update the values of the `client_id` and `client_secret` variables with the ones for your application.

Once completed, open the `Cronofy API` environment in Postman and click on the **Authorization** tab.

![](/developers/getting-started/postman/postman-environment.07b955aa6f1df86543089980dff967ad1b10b4d4f2e1b81cf5ad5af6d9cf5ef8.png)
## 3. Generate an access_token
You can use Postman to generate an access_token to work with your calendars.

In the Authorization Tab, fill the Configure New Token fields with the values described below.

Then switch to the Authorization tab. Choose the **Auth Type** as `OAuth 2.0`.

![](/developers/getting-started/postman/postman-auth.1dd9fedc7b398cd9dc2bda33380cb1c3a79263bdd71161a7c3704e15a4e63191.png)
- Token Name - `Cronofy Access Token`

- Grant Type - `Authorization Code`

- Callback URL - `http://postman.test/auth/cronofy/callback`

- Auth URL - `https://app.cronofy.com/oauth/authorize`

- Access Token URL - `https://api.cronofy.com/oauth/token`

- Client ID - `{{client_id}}`

- Client Secret - `{{client_secret}}`

- Scope - `read_write`

- State - can be left blank

- Client Authentication - `Send client credentials in body`

> **INFO:** **A note about Data Centers:** If you have selected a data center other than the US you will need to adjust some of the URLs specified above:

- The Auth URL should have the subdomain matching your DC's "Site host".

- The Token URL should have the domain matching your DC's "API host".

- Each endpoint in the collection should have its domain matching your DC's "API host".

Please review [Data Centers](/developers/data-centers/index.md) for additional information on this.

Click **Get New Access Token** and complete the authorization.

## 4. Make your first API call
Now that you have an Access Token, you can make your first API call. List Calendars is a good place to start. This will show you a list of calendars from the connected calendar account.

![](/developers/getting-started/postman/postman-read-calendars-output.d4c8d7fc85a60a34c0307c64f703d9cf965f953846ecddac018fc63eaf596484.png)

---
[Read in HTML](/developers/getting-started/postman/)