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

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

Your small business manages customers, quotes and invoices in Axonaut, and your tool built with Claude needs to use them. The Axonaut credential opens the management of the whole company, 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.

Axonaut brings together a small business's management: customers, quotes, invoices, projects, sometimes HR and accounting. A tool built with Claude or ChatGPT takes over when you need **a screen the software does not have**: a table of quotes to follow up for the sales team, a project tracker for a client, a monthly summary for management. To do that, it needs the **Axonaut API credential**, and that credential opens **the management of the whole company** (source 1).

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

> **The short version.** Show your key in Axonaut's Settings, under API v2. Ask your AI to connect Axonaut, then paste it into while through the link it gives you. The tool reads your customers, quotes and invoices, every call is logged, and a write waits for the rule you approve.

## Connect Axonaut to your tool, in three steps

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

1. **Show your key in Axonaut.** Open **Settings**, through the wrench icon, then **API** and the **API v2** tab, and click to show your key (source 1).
2. **Ask your AI to connect Axonaut.** It declares the connection in while, with the **userApiKey** header Axonaut expects, and gives you a link (source 1).
3. **Paste the key into while.** You open the link, paste the key and confirm. Neither your AI nor the tool's code sees it.

> You, to your AI: Connect Axonaut to this tool, and build a table of quotes sent more than two weeks ago and not yet signed, with the customer, the amount and the salesperson.

<figure class="illus"><img src="/illustrations/axonaut-relais-1200.webp" srcset="/illustrations/axonaut-relais-768.webp 768w, /illustrations/axonaut-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 Axonaut API through while: the credential is added to each call inside while, out of the code, every read of customers, quotes and invoices is logged, and creating an invoice waits for a person's approval" /><figcaption>The tool calls Axonaut through while, which adds the credential to each call.</figcaption></figure>

## What while does on each call

The tool calls Axonaut **through while**, without a credential. while adds the key 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 an invoice, goes through once you approve its rule. After that, an unexpected call is refused, and your AI is told.

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

> You, to your AI: Ask me before every invoice creation in Axonaut.

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/).

## 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/).
- **A client** follows their project with [an access link and a password](/en/guides/share-app-with-password/), valid for 1, 7 or 30 days.
- **The tool's data** is backed up every day, and your tools are hosted in France by Nextmap.

To go further, see [the quote tracker](/en/guides/quote-tracker-small-business-ai-2026/), [connect Pennylane](/en/guides/connect-pennylane-api-ai-tool/) and [connect Qonto](/en/guides/connect-qonto-api-ai-tool/).

## Try it with your tool

Give this message to your AI, then ask it to connect Axonaut. 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. [Axonaut, llms.txt](https://axonaut.com/llms.txt), 2026-11-18
2. [Axonaut, API v2 (Swagger)](https://axonaut.com/api/v2/doc), 2026-11-18

## Questions

### Where do you find the Axonaut API key?

In Axonaut, open Settings, through the wrench icon, then API and the API v2 tab, and click to show your key (source 1).

### What does the Axonaut API cover?

Business management: CRM, invoicing, quotes, projects, HR and accounting, with both reading and writing (sources 1 and 2).

### How does Axonaut expect the credential?

In the userApiKey header of each request, written exactly that way. while adds it there on each of the tool's calls (source 1).

### Does my AI see the Axonaut credential?

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

### Can you block the tool from creating an invoice?

Yes. On while, ask for your approval before each invoice creation: it waits for your approval before reaching Axonaut.
