Skip to main content

Use Postman with Metronome

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

With those in place, you can use Postman with Metronome in two different ways:

  • Using the Metronome OpenAPI spec
  • Using the Metronome public Postman collection

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/openapi.json).
  3. On the next pane, select Show advanced settings and make sure the Folder organization is set as Tags.

Postman OpenAPI import screenshot

Use the Metronome public Postman collection

The Metronome public collection can be accessed via

Run in Postman

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.

Metronome logoMetronome logo