Skip to main content
This guide walks through the end-to-end workflow for using Standalone API Keys with Pleo APIs. You’ll be using cURL to make the API calls. If you prefer to test with Postman:

​
Before You Start

You must have: If you do not see API Keys under Settings, Standalone API Keys are not enabled for your organisation.

​
What You’ll Have Built

By the end of this workflow:
  • You have generated a Standalone API Key
  • You understand environment and permission scoping
  • You have successfully authenticated against the Pleo API

​
Workflow Steps

​
1. Generate Your Standalone API Key

Purpose: Create an API Key in the Pleo Web App for your chosen environment. Input: No inputs. See Before You Start section. Output: A scoped API Key usable for authenticating API requests. Integration Design / Why It Matters:

​
2. Authenticate Your First API Request

Purpose: Confirm API connectivity using your Standalone API Key. Input:
  • API Key (authentication header)
  • company_id associated with your Pleo company
Output: A successful API response confirms your key is valid and your requests are correctly scoped.

​
Result

After completing this guide:
  • You have a valid Standalone API Key
  • You have confirmed API connectivity
  • You have a working authenticated setup

​
What Comes Next?

If you’re a Pleo Customer building your own integration, explore the Platform Capabilities & Concepts Catalogue to understand the different workflows, such as exports, imports, and multi-entity setups, that you can build with the API.