---
title: "Qonto API: connect it to a tool built with AI (2026)"
url: https://while.sh/en/guides/connect-qonto-api-ai-tool/
author: "Aloïs Oddon, co-founder of Nextmap"
updated: 2026-11-18
---

# Connect Qonto to a tool built with Claude or ChatGPT (2026)

Your tool built with Claude needs to read Qonto's transactions to track cash flow, or prepare quotes and invoices there. The Qonto secret opens the company's accounts, and it must end up neither in the code nor in the conversation. On while, it stays in while, and your AI never sees it. Here is how.

Qonto holds the company's accounts, incoming payments, the team's cards, the statements. A tool built with Claude or ChatGPT becomes valuable when it **reads that data**. It shows the week's cash flow, the client payments that came in, spending by label. To do that, it needs **the Qonto API secret**, and that secret opens the accounts of the whole company.

That is where things often go wrong: **the secret ends up pasted into the code**, or into the conversation with the AI, where it can leak. On while, the Qonto secret **stays in while**. The tool calls Qonto without ever holding it, and your AI never sees it.

> **The short version.** Get your organization's login and secret key in Qonto. Ask your AI to connect Qonto, then paste the secret into while through the link it gives you. The tool reads your accounts, every call is logged, and a write waits for the rule you approve.

## What the Qonto API key allows

Qonto offers two ways to connect to its API. For a small business's internal tool, the organization's API key is enough (sources 1 and 2).

| | Organization API key | OAuth 2.0 |
|---|---|---|
| Who it is for | A Qonto customer, for its own tools | Qonto's partner software |
| What it allows | Part of the API | The whole API, depending on granted scopes |
| Accounts, transactions and statements | Yes | Yes |
| Clients, quotes and invoices | Yes | Yes |
| Transfers between your accounts | Yes | Yes |
| SEPA transfers to a beneficiary | No | Yes |

With the API key, a tool reads **the organization and its accounts**, the **transactions**, the **statements** and the **attachments**. It also manages **clients, quotes and invoices**, both client and supplier, and transfers between the organization's accounts (source 2). A SEPA transfer to a beneficiary requires OAuth 2.0: no payment to a third party goes out this way.

## Connect Qonto to your tool, in three steps

The whole thing takes a few minutes, and you have no code to write.

1. **Get the secret in Qonto.** On the web, choose the organization if you have several, then open **Integrations and Partnerships** and the **API key** section. Qonto shows the organization's login and its secret key there. If the key does not exist yet, generate it (source 1).
2. **Ask your AI to connect Qonto.** It declares the connection in while, in the form Qonto expects, and gives you a link.
3. **Paste the secret into while.** You open the link, paste what it asks for and confirm. Neither your AI nor the tool's code sees the secret.

Qonto expects the login and the secret key **together**, separated by a colon, in the Authorization header (source 1). Your AI knows this when it declares the connection, and while adds it to each call.

> You, to your AI: Connect Qonto to this tool and show the week's cash flow: the balance of each account, the payments received and the largest expenses.

<figure class="illus"><img src="/illustrations/qonto-relais-1200.webp" srcset="/illustrations/qonto-relais-768.webp 768w, /illustrations/qonto-relais-1200.webp 1200w" sizes="(min-width: 48rem) 46rem, 100vw" width="1536" height="1024" loading="lazy" decoding="async" alt="The tool built with AI calls the Qonto API through while: the Qonto secret is added to each call inside while, out of the code, every read of the accounts and transactions is logged in the history" /><figcaption>The tool calls Qonto through while, which adds the secret to each call.</figcaption></figure>

## What while does on each call

The tool calls Qonto **through while**, without a secret. while adds the login and the secret to each call, and logs it in the history. For the first seven days, reads go through and teach while what the tool calls. **A write**, like creating a quote or sending an invoice, goes through once you approve its rule. After that, an unexpected call is refused, and your AI is told.

For a bank, caution makes sense. You can ask for your approval before a sensitive call.

> You, to your AI: Ask me before every invoice sent and every transfer between our accounts.

The credentials of your software are detailed on our [security](/en/security/) page, and the same mechanism works for any API in [connect an API with no credentials in the code](/en/guides/api-keys-out-of-code/).

## Changing the secret

If the secret leaks, generate a new one in Qonto. **Paste it into while**: the tool uses it from the next call, without being put back in place, and your AI has nothing to redo.

## What while adds around it

- **Your colleagues** use the tool with a while account for up to 3 people, or, on the Pro plan, with their email account, Google or Microsoft. See [keep a tool for your colleagues](/en/guides/internal-tool-company-sign-in/).
- **Your accountant** can use it with [an access link and a password](/en/guides/share-app-with-password/), valid for 1, 7 or 30 days.
- **Connected software**: one on the Libre plan, and 25 on the Pro plan, Qonto included.
- **The tool's data** is backed up every day, and your tools are hosted in France by Nextmap.

For accounting, see [connect Pennylane](/en/guides/connect-pennylane-api-ai-tool/), and for tool ideas, [expense reports](/en/guides/expense-tracker-small-business-ai-2026/) and [the quote tracker](/en/guides/quote-tracker-small-business-ai-2026/).

## Try it with your tool

Give this message to your AI, then ask it to connect Qonto. The trial is **free, with no sign-up**, and your tool has its address **in 3 minutes**.

```text titre="The message to give your AI"
Read while.sh/agents and help me get started with while.
```

## Sources

1. [Qonto, API key](https://docs.qonto.com/get-started/business-api/authentication/api-key), 2026-11-18
2. [Qonto, Scopes and endpoints access](https://docs.qonto.com/api-reference/business-api/introduction/authentication/scopes), 2026-11-18

## Questions

### How do you get access to the Qonto API?

In Qonto, on the web, choose the organization, then open Integrations and Partnerships and the API key section. Qonto shows the organization's login and its secret key there, to generate if it does not exist yet (source 1).

### What does the Qonto API key allow?

Part of the API: reading the organization, accounts, transactions and statements, and managing clients, quotes, client and supplier invoices and attachments. For the rest, Qonto requires OAuth 2.0 (sources 1 and 2).

### Can you make a transfer with the Qonto API key?

Only between your organization's own accounts. A SEPA transfer to a beneficiary is not among the endpoints the API key allows, and goes through OAuth 2.0 (source 2).

### Does my AI see the Qonto secret?

No. Your AI declares the connection to Qonto and gives you a link. You paste the secret into while there, and neither your AI nor the tool's code sees it.

### How does Qonto expect the credentials in the request?

In the Authorization header, the login and the secret key separated by a colon, with no encoding (source 1). while adds it to each of the tool's calls.
