- Confirm whether you already have access
- Request or obtain access if needed
- Continue the workflow once access is available
1. How to Confirm Access
You have environment access if:- You can log into the Pleo Web App for Staging or Production
- On the main menu on the left-hand side, you see Settings → API Keys
- You have Admin or Bookkeeper permissions
2. Identify Your Role
Access depends on whether you are a Pleo Partner or a Pleo Customer.Pleo Partners
New Pleo Partners
If you are onboarding as a new partner:- Follow the How to Get Access to Staging (OAuth 2.0) article
- During onboarding, Pleo may enable Standalone API Key access for exploration purposes
- Once access is confirmed, continue with the Standalone API Key Workflow Guide
Existing Pleo Partners
If Standalone API Key access has already been enabled:- Use your existing Staging or Production login
- Continue directly with the Standalone API Key Workflow Guide
Pleo Customers
New Pleo Customers
You can create a Pleo account via the Pleo website, however:- Standalone API Key access is not enabled by default
- Access to the new External APIs is granted only in specific cases
Existing Pleo Customers
If Standalone API Key access was enabled for your organisation:- Log into your existing Pleo environment
- Ensure you have Admin or Bookkeeper permissions
- Continue with the Standalone API Key Workflow Guide
What Comes Next?
this how-to is part of:
FAQs
What is the difference between legacy APIs and new APIs?
What is the difference between legacy APIs and new APIs?
Legacy APIs (OpenAPI)
- Base URL:
https://openapi.pleo.io - Authentication: API tokens (legacy tokens)
- Availability: Intended for existing/legacy use cases. Access can depend on your account setup and entitlements.
- Lifecycle: Deprecated. Pleo is working on a deprecation timeline and migration plan.
- Base URL:
https://external.pleo.io - Authentication: API keys (and other authentication methods supported by the platform, including OAuth 2.0, depending on the use case)
- Availability: Restricted access. Documentation may be publicly visible, but access is not broadly enabled by default. Standalone API keys require explicit enablement.
- What to expect: Newer platform surface and improved structure, but not guaranteed feature parity with legacy APIs yet.
- Legacy API tokens will not work on
external.pleo.io - New API keys will not work on
openapi.pleo.io