# Pleo

:::tip Available
This integration is available in Frihet. Set it up in **Settings → Integrations → Pleo**.
:::

Connect your Pleo account to Frihet to automatically import expenses made with Pleo corporate cards. If your team uses Pleo cards for daily expenses, this integration allows you to have all those expenses recorded in Frihet without manual intervention, including merchant data, amount, and category.

## What it's for

- **Import card expenses** — Each payment made with a Pleo card is imported as an expense in Frihet with the merchant name, amount, and category
- **Automatic categorization** — Pleo categorizes expenses, and that category is transferred to Frihet as a suggestion
- **Team expense visibility** — Consolidate all your team's Pleo card expenses in Frihet
- **Smart deduplication** — Already imported expenses are not duplicated in subsequent imports

## Requirements

- Active account on [Pleo](https://pleo.io)
- Frihet Pro or Premium Plan
- Pleo API Token

## How to connect

### Step 1: Obtain your API Token in Pleo

1. Log in to [app.pleo.io](https://app.pleo.io) with an administrator account
2. Go to **Settings**
3. Select **Integrations**
4. Look for the **API** or **Developer** section
5. Click to generate a new API token
6. Give it a descriptive name, for example "Frihet ERP"
7. Copy the generated token

### Step 2: Configure in Frihet

1. In Frihet, go to **Settings → Integrations**
2. Find **Pleo** and click on the card
3. Paste your **API Token** into the corresponding field
4. Click **Test Connection** to verify
5. If the connection is successful, click **Save**

## How it works

Frihet connects to the Pleo API using your API Token for authentication. When you initiate an import, Frihet queries the expenses recorded on Pleo corporate cards and imports them as expenses into your Frihet account.

The import is on-demand. Completed expenses are imported with all available information: merchant, amount, category, and date.

### Data mapping

| Data in Pleo | Field in Frihet |
|--------------|-----------------|
| Merchant name (merchant) | Expense description |
| Amount | Expense amount |
| Charge date | Expense date |
| Currency | Expense currency |
| Pleo category | Expense category |
| Cardholder | Expense notes |

## Use cases

### Team with company cards

Each member of your team has a Pleo card with a configured limit. Instead of each person manually recording their expenses in Frihet, you import all Pleo expenses at once. Each expense arrives with the merchant name and assigned category.

### Travel expense control

Your team travels for client meetings. Hotel, transportation, and meal expenses are paid with Pleo. By importing them into Frihet, you have a complete record of the cost of each trip that you can associate with a client or project.

### Subscriptions and recurring expenses

You pay for SaaS tools and services with Pleo. By importing expenses monthly, you can track the cost of each subscription and detect unexpected or duplicate charges.

## Troubleshooting

### Connection error

- Verify that the API Token is correct and was generated with an administrator account
- Check that your Pleo plan includes API access
- If the token was revoked or regenerated, update it in Frihet

### Expenses are not imported

- Only completed and confirmed expenses are imported
- Expenses pending approval in Pleo do not appear until approved
- Check the date range of the import

### Missing merchant data

- Some expenses may not have a merchant name if Pleo could not identify it
- In such cases, the transaction reference will appear instead

## Next steps

- [Connect Qonto to import bank transactions](./qonto)
- [Learn how to categorize imported expenses](../gastos/categorias)
- [Manage recurring expenses in Frihet](../gastos/gastos-recurrentes)