Postman is a great way to visually explore the Metronome API without writing code. Before you start, you need to:

​
Use the OpenAPI spec​

The Metronome OpenAPI spec can be imported directly into Postman. The spec is always up to date. To import the OpenAPI spec:
  1. In Postman, go to File > Import.
  2. Select Link from the top menu, and enter Metronome’s OpenAPI spec link (https://api.metronome.com/v1/docs/openapi).
  3. On the next pane, select Show advanced settings and make sure the Folder organization is set as Tags.
Postman OpenAPI import screenshot

​
Set up authorization for the Metronome collection​

The Metronome API uses a Bearer Token. To set Auth up in the collection, click on your collection’s top-level Metronome folder and select Bearer Token.
Set Auth to bearer token
We recommend using a Postman variable for the token value. To do this, enter {{api_token}} in the box below the Type dropdown. A window appears referencing an unresolved variable. In that box, click on Add new variable , add your Metronome API token as the value, and set the scope to Collection: Metronome.
Create variable in Postman for API token

​
Organize the Metronome collection​

A Postman Collection groups requests together in a folder structure, allowing them to be easily organized. You can fork the collection if needed. Forking provides for version control and facilitates collaboration.

​
Try it out​

To test the Metronome API using Postman, create a new customer using the Create customer request. To do so you must configure the Create customer request to use the Bearer Token variable {{api_token}}.
  1. Navigate to Customers > POST Create customer.
  2. Select Authorization , then select Bearer Token from the Type dropdown. Since we scoped {{api_token}} for the entire collection, the Token value should automatically be set to {{api_token}}. If not, just enter {{api_token}} in the Token box.
  3. Save your changes to the Create customer request.
Set auth for create customer request
Now that auth is set, create a new customer using the below JSON as the body of the request. Navigate to Customers > POST Create customer , select Body from the request options in the panel, then enter the following: 
{
 "name": "Example-Customer"
}
The API response is in the format 
{
  "data": {
    "id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
    "external_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
    "name": "Example-Customer"
  }
}
Now that the collection is set up, you can continue with the Metronome API.