Prerequisites
- You have completed Pleo’s registration process
- You have received your Client ID and Client Secret from Pleo
- You have logged into Postman and have created a collection
Steps
1. Configure a new token
- Open your Postman collection
- Click the Authorization tab
- Select OAuth 2.0 as the Auth Type
- Scroll to the Configure New Token section
- Provide the following configuration:
| Parameter | Configuration |
|---|---|
| Grant type | Authorization Code (With PKCE) |
| Callback URL | The Postman redirect endpoint URIs you registered |
| Auth URL | {AUTHORIZATION_SERVER_URL}/oauth/authorize |
| Access Token URL | {AUTHORIZATION_SERVER_URL}/oauth/token |
| Client ID | Client ID you received after registration |
| Client Secret | Client Secret you received after registration |
| Code Challenge Method | SHA-256 |
| Code Verifier | Leave blank, or provide a valid PKCE code verifier. |
| Scope | Enter space-delimited list of API scopes that you registered |
| Client Authentication | Send as Basic Auth Header |
We recommend using Postman environment variables to store the authorisation server base URL and client credentials. This allows you to quickly switch between staging and production environments.
2. Get a new Access Token
- Scroll down and click Get New Access Token.
- A new browser window opens and redirects you to Pleo’s authorisation server
- Complete the authorisation process and grant access using your staging credentials
- After authorisation, you are redirected back to Postman
- Click Use Token
Postman can automatically obtain new access tokens when existing tokens expire. Ensure the Auto-refresh Token toggle is enabled.
Result
- Postman is configured to authenticate with Pleo using OAuth 2.0
- You can make authenticated requests to Pleo’s staging APIs
- Postman manages the access token lifecycle automatically
What Comes Next?
this how-to is part of:
Related Reading
- OAuth 2.0 Setup Workflow Guide Step-by-step instructions on how to configure OAuth 2.0 where you handle the full token lifecycle