Pleo as a spend management platform can be integrated with other third-party ERP/accounting applications or Human Resources Information Systems (HRIS) to make it more optimised for our customers. These applications make Pleo more dynamic and are useful in automating workflows and supporting additional functionalities.
All the applications that are available for integration with your Pleo account are listed in the App Marketplace.
Installations
An installation is an integration between an application and a Pleo subject. When an application is integrated with Pleo for a user's account, an installation is created.
As an external developer, you can manage the application installations using the Installations API. The API allows you to create, update, and delete installations, as well as retrieve information about them.
The installation has a metadata attribute that the application uses to store additional information about the installation. This can be useful for storing configuration settings or other data specific to the installation.
Note: This
metadatais in no way used or processed by Pleo, and is only stored for the application to use.
Listing New Application in the App Marketplace
As an external developer commissioned by Pleo, if you want any new application to be listed in the app marketplace, you must
Creating Installations
OAuth
If you are using OAuth 2.0 as your authorisation method, the installation would automatically complete when the OAuth process is finished. If the application that you have installed requires configurations for activation, you might need to send a request to the POST Activate the installation for a client endpoint to set the status to ACTIVATED. Otherwise, the installation is created with the status ACTIVATED by default.
Installation Status
There are the following possible status of an installation:
| Status | Description |
|---|---|
AUTHORIZED | The user has completed the authorisation process, but the installation is not yet active or ready for use. |
ACTIVATED | The installation is active and ready for use. |
INACTIVE | The installation is inactive and cannot be used. This status occurs after multiple failed attempts to connect to the target application. It also happens if the authorisation method used for the installation is no longer valid, for example using expired refresh tokens for the integration. |
PENDING_INTEGRATION | This status occurs when the integration is synchronising or performing other background tasks. When an installation is in progress, the integration synchronises the user's Pleo account with the target application, so that tax codes, tags, and vendors are all similar in both Pleo and the third-party application. The user must not disconnect the application in this state; else there would be data loss. |