Skip to main content
This how-to covers making an API call using OAuth 2.0 and Postman. For the full non-Postman setup, where you manage the entire token lifecycle, see the OAuth 2.0 Setup Workflow Guide instead.

Prerequisites

Before you begin:

Steps

1. Create an HTTP Request

In the Postman collection where you’ve configured OAuth 2.0:
  1. Click New and then select HTTP Request
  2. Ensure that the HTTP method corresponds to the endpoint being called, for example: GET
  3. Enter the Staging URL for the Pleo API you want to test, for example: https://external.staging.pleo.io/v2/employees
Postman GET HTTP Request
Each API endpoint has both a Staging and a Production URL. You can find these in the Pleo API Reference sections.
Pleo API URLs in docs

2. Add authorisation

  1. Click the Authorization tab
  2. Select OAuth 2.0 as the Auth Type
  3. Select the OAuth 2.0 token you previously created from the Token dropdown menu
  4. Postman automatically injects: Authorization: Bearer <access_token>
Postman Auth Type

3. Send the request

  1. Click the Send button at the top of the screen
  2. If everything is configured correctly, you should receive a JSON response
Postman Auth Type

Result

After completing these steps:
  • You have successfully made a Pleo API call using OAuth 2.0 in Postman

What Comes Next?


this how-to is part of: