Skip to main content
↑ IMPROVED

Tag Groups API

Tag, tag group, and tag dimension create/update endpoints now return a clean 400 Bad Request when a name, code, or value field exceeds 255 characters, instead of an unhandled 500 error
+ ADDED

New Brand, New Look, Same Great Docs

We’ve rebranded the entire Developer Portal to match Pleo’s new brand identity, with new typography, colours, logo, icons, illustrations, and a redesigned homepage, in both light and dark mode
Explore the new homepage to see it in action
+ ADDED

Pleo MCP

New How to Install the Pleo MCP in ChatGPT Business guide for publishing and authorising the Pleo MCP in ChatGPT Business, Enterprise, and Edu workspaces
Added a Troubleshooting section to the Pleo MCP FAQs covering common ChatGPT Business install and connection issues
+ ADDED

Export API Version 3

Added explicit target system support for export jobs:
Create a new export job now accepts an optional targetSystem field, validated against the company’s active connections; supplying an unrecognised value returns a 422 with an INVALID_TARGET_SYSTEM error
Get a list of export jobs now supports an optional target_systems filter to narrow results to one or more explicit target systems; supplying an unrecognised value returns a 422 with an INVALID_TARGET_SYSTEM_FILTER error
Get a list of export jobs and Get an export job responses now include a targetSystem field, showing which system each job resolved to
+ ADDED

Pleo MCP

New Pleo MCP documentation suite. You can now connect Pleo to AI assistants like Claude, ChatGPT, Codex, Gemini Enterprise, and Copilot, so users can ask their assistant to handle Pleo tasks directly.
Enable Pleo MCP for your organisation with one of the supported platforms: Claude, Codex, ChatGPT, Gemini Enterprise, or Copilot
Enable Pleo MCP per user by connecting it to Claude, Codex, ChatGPT, Copilot, or any custom MCP-compatible client
Revoke access to disconnect the Pleo MCP when it’s no longer needed
Example Use Cases, FAQs, and Access & Permissions to help users understand what they can do and who can do it
↑ IMPROVED

Enrichment API Reference

Clarified Enrichment Workflow Quick Guide prerequisites: your integration must already have the receipt, the card’s last four digits, and any other matching information before submitting a request
+ ADDED

Export API Version 3

New field attendeesData has been added to the Export API version 3. For more information see GET Get Export Items.
+ ADDED

Developer Portal Docs

New Imports -> Tax Sync documentation suite:
New Integration Design -> Tax Sync covering the sync execution model, reconciliation behaviour, type mapping, data mapping, and scheduling
New how-to articles with step-by-step instructions, curl examples, and Pleo Web App screenshots:
New Classifying Expenses: Tags, Categories, and Tax Codes overview, explaining how Tags Sync, Chart of Accounts Sync, and Tax Sync fit together to classify an expense, with manual Pleo Web App setup and export options
Archived the old Configuring Customer Account in Pleo pages (Tax Codes, Categories, Tags) in favour of the new Classifying Expenses overview
+ ADDED

Developer Portal Docs

New Imports -> Chart of Accounts Sync documentation suite:
New Integration Design -> Chart of Accounts Sync covering the sync execution model, reconciliation behaviour, data mapping, and scheduling
New how-to articles with step-by-step instructions:
How to Sync Accounts: fetch accounts from the AS and Pleo, then match by externalId
How to Create, Update, and Archive Accounts: apply create, unarchive, update, and archive operations
How to Create Multiple Accounts in a Single Request: batch create up to 1000 accounts in one API call
↑ IMPROVED

Accounting Entries API

Accounting Entries API is now available. See migration guides.
+ ADDED

Developer Portal Docs

New Imports -> Chart of Accounts Sync documentation suite:
New Integration Design -> Chart of Accounts Sync covering the sync execution model, reconciliation behaviour, data mapping, and scheduling
New how-to articles with step-by-step instructions:
How to Sync Accounts: fetch accounts from the AS and Pleo, then match by externalId
How to Create, Update, and Archive Accounts: apply create, unarchive, update, and archive operations
How to Create Multiple Accounts in a Single Request: batch create up to 1000 accounts in one API call
↑ IMPROVED

Accounting Entries API

Updated Accounting Entries API Availability Date
+ ADDED
+ ADDED

Enrichment API Reference

New Enrichment API Overview: key concepts, authentication, request parameters, receipt statuses, and supported features
New Enrichment Workflow Quick Guide: condensed guide covering the three workflow steps and the optional tags path
New Enrich Accounting Entry v2 endpoint reference
↑ IMPROVED

Developer Portal Docs

AS/ERP Integration improvements:
Improved look and feel of the Export Integration Workflow Guide and AS/ERP Processing Workflow Guide to match the Tags Sync guide pattern, with expanded step descriptions, sub-flow diagrams, and black CTA buttons
Added sub-flow diagrams to all export how-to articles, showing the steps for each how-to inline below the top navigation diagram
Updated Detect & Start Export Jobs terminology across all export docs (previously “Detect & Claim”) to avoid misinterpretation in external partner accounting workflows
Clarified eligible job status for normal detection: pending only; in_progress is only included when recovering from an interrupted job
Corrected batch limit for Update Export Items from 10 to 100 items per API request
+ ADDED

Deprecation and Migration

Updated availability dates across migration plan tables
+ ADDED

Export API Version 3

New fields ingoingTaxAccount and outgoingTaxAccount have been added to the Export API version 3. For more information see GET Get Export Items.
+ ADDED

Export API Version 3

Added support for Swedish representation tax calculations. No schema changes were made to data.accountingEntryLines.tax; however, the underlying tax application logic reflected in the UI has changed to support Swedish entertainment expense deduction rules. For more information, see Change VAT & tax deductions for entertainment expenses in Sweden .
↑ IMPROVED

Developer Portal Docs

Glossary Updates
Included expense subtypes: interest, invoice_payment_sent, invoice_payment_returned, reimbursement_to_employee, reimbursement_to_company, and reimbursement_to_employee_refund
↑ IMPROVED

Developer Portal Docs

New AS/ERP Integration section covering the full Export workflow:
Getting Started landing page
Integration Design sections for all Export steps including bookkeeping methods, accounts mapping, posting behaviour, attachment handling, and accounting periods
Full suite of How-to articles covering each step end-to-end
Troubleshooting articles:
More improvements coming soon!
↑ IMPROVED

Developer Portal Docs

New API Base URLs article
New Standalone API Keys Sections:
New Integrated API Keys Sections:
More improvements coming soon!
↑ IMPROVED

Developer Portal Docs

Added Concepts and Terminology section explaining integration, application, and OAuth 2.0 client
Standardised terminology across OAuth 2.0 documentation, guides and how-to’s
Clarified permissions needed to generate API Keys
↑ IMPROVED

Developer Portal Docs

General improvements to Build with Pleo section
More improvements coming soon!
↑ IMPROVED

Developer Portal Docs

General improvements to Build with Pleo section including:
More improvements coming soon!
+ ADDED

Export API Version 3

Multi-currency support has been extended to Bill Invoice Payments in the Export API version 3. For more information see GET Get Export Job Items.
+ ADDED

Chart of Accounts API

POST Fetch a list of accounts endpoint has been updated:
code is marked as deprecated.
codes is a new optional preferred search field.
For more information see POST Fetch a list of accounts.
+ ADDED

Chart of Accounts API

New endpoint to create multiple bookkeeping accounts in a single batch operation has been added to the Chart of Accounts API. For more information see POST Create multiple accounts in a single request.
+ ADDED

Export API Version 3

New field subType has been added to the Export API version 3. For more information see GET Get Export Job Items.
+ ADDED

Export API Version 2

New field subType has been added to the Export API version 2. For more information see GET Get Export Job Items.
+ ADDED

Chart of Accounts API

New search fields excludeIfAssignedToContraAccount, excludeIfAssignedToCategory have been added to the Chart of Accounts API. For more information see POST Fetch a list of accounts.
+ ADDED

Export API Version 3

New field servicePeriod has been added to the Export API version 3. For more information see GET Get Export Job Items.
+ ADDED

Export API Version 2

New field servicePeriod has been added to the Export API version 2. For more information see GET Get Export Job Items.
+ ADDED

Export API Version 3

New failure reason type tag_unknown has been added to the Export API Version 3. For more information see GET Get Export Job Items and PUT Update Export Job Items.
+ ADDED

Export API Version 3

New failure reason type tax_code_unknown has been added to the Export API Version 3. For more information see GET Get Export Job Items and PUT Update Export Job Items.
+ ADDED

Export API Version 3

New failure reason type account_unknown has been added to the Export API Version 3. For more information see GET Get Export Job Items and PUT Update Export Job Items.
+ ADDED

Export API Version 3

New failure reason type vendor_unknown has been added to the Export API Version 3. For more information see GET Get Export Job Items and PUT Update Export Job Items.
+ ADDED

Companies API

The Companies API is available to search for companies associated with an organisation. You can also retrieve details of a specific company. For more information, see Companies API Overview.
↑ IMPROVED

Chart of Accounts API

The Accounts API is renamed to the Chart of Accounts API. For more information, see Chart of Accounts API Overview.
+ ADDED

Export API Version 3

A new version is released to support multi-currency configuration. For more information, see Multi-Currency Configuration. The significant changes introduced in this version are:
In the endpoints’ response, values of enums are now returned as strings.
GET Get Export Items endpoint:
controlAccount object is returned in the endpoint response.
teamCode is removed from the endpoint response.
GET Get a list of Export Jobs endpoint:
status is removed from the query parameters of the endpoint request.
statuses is the query parameter to request jobs in specific states.
↑ IMPROVED

Webhook Subscriptions | Basic and Header-Based Authentication

We now support Basic and Header-Based authentication methods, in addition to HMAC signature-based authentication. For more detailed information, see Authentication in Webhooks. Also, now an integration can send custom headers in a new subscription request — see Configuring Custom Headers in New Subscription Request.
↑ IMPROVED

Export API Version 2

You can now tag vendors to an expense, if the specific company has synchronised vendors between their ERP/accounting system and Pleo. Also, the integration must support vendor tagging. For more information on vendor specific data points that you might receive in an API response, see POST Get Export Items `.
+ ADDED

Accounts API Version 1

The Accounts API is now available for synchronisation of accounts between the ERP/accounting system and Pleo. For more information, see Accounts API.
+ ADDED

Vendors API Version 1

The Vendors API is now available for synchronisation of vendors records between the ERP/accounting system and Pleo. For more information, see Vendor API Overview.
+ ADDED

Accounting Entries Enrichment API Version 1

The Accounting Entries Enrichment API Version 1 is available for select partners and customers. For more detailed information, see Accounting Entries Enrichment API Overview.
+ ADDED

Employees API Version 2

The Employees API Version 1 is deprecated and in Version 2, these attributes have been removed: teamId, avatar and role. In addition, you can search for employee details of an organisation or company by companyId, email, or code in Version 2. For more information, see Employees API Overview.
+ ADDED

Export API Version 2

V1 is operational, but we recommend you to upgrade to V2 for better user experience - the user attribute in GET Get Export Items response would be null, if there is no user/employee associated with the export item. For more information, see Export API. Also, V0 would be deprecated in 2025. Closer to the deprecation date, we would inform you.