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

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

Your customers answer in Typeform, and your tool built with Claude needs to sort their responses, track them and follow up. The Typeform token can read and delete your forms, 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.

Typeform collects your customers' answers: quote requests, sign-ups, satisfaction surveys. A tool built with Claude or ChatGPT takes over **after the answer**: sorting requests, assigning each one to a salesperson, tracking those waiting for a call back. To read your responses, it needs a **Typeform API token**, and a token that is too broad can **read, edit and delete** your forms (source 1).

That is where things often go wrong: **the token ends up pasted into the code**, pushed to GitHub, where it is detected and disabled, and the tool stops. On while, the Typeform token **stays in while**. The tool calls Typeform without ever holding it, and your AI never sees it.

> **The short version.** Generate a personal access token in Typeform, with read scopes only. Ask your AI to connect Typeform, then paste the token into while through the link it gives you. The tool reads your form responses, and every call is logged.

## Connect Typeform to your tool, in three steps

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

1. **Generate a token in Typeform.** Open the menu next to your name, then **Account** and **Personal tokens**. Click **Generate a new token**, give it the tool's name, choose the **forms:read** and **responses:read** scopes, then Generate token (sources 1 and 2).
2. **Ask your AI to connect Typeform.** It declares the connection in while and gives you a link. If your account stores responses **in Europe**, tell it: the API address becomes api.eu.typeform.com (source 3).
3. **Paste the token into while.** You open the link, paste the token and confirm. Neither your AI nor the tool's code sees it.

> You, to your AI: Connect Typeform to this tool, read the responses of the "Quote request" form, and build a list where each request is assigned to a salesperson, with its status.

<figure class="illus"><img src="/illustrations/typeform-relais-1200.webp" srcset="/illustrations/typeform-relais-768.webp 768w, /illustrations/typeform-relais-1200.webp 1200w" sizes="(min-width: 48rem) 46rem, 100vw" width="1536" height="1024" loading="lazy" decoding="async" alt="The tool built with AI reads Typeform responses through while: the personal access token is added to each call inside while, out of the code, every read of form responses is logged, and requests are sorted and assigned in the tool" /><figcaption>The tool reads Typeform through while, which adds the token to each call.</figcaption></figure>

## What while does on each call

The tool calls Typeform **through while**, without a token. while adds the token to each call, and logs it in the history. For the first seven days, reads go through and teach while what the tool calls. If the tool ever needs to write, like creating a form, the write goes through once you approve its rule. After that, an unexpected call is refused, and your AI is told.

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 token

If the token has leaked, Typeform advises **regenerating** it from the same page, through the three-dot menu on the token's row (source 1). **Paste the new one into while**: the tool uses it from the next call, without being put back in place.

## 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/).
- **Connected software**: one on the Libre plan, and 25 on the Pro plan, Typeform included.
- **The tool's data** is backed up every day, and your tools are hosted in France by Nextmap.

To follow requests through to signature, see [the quote tracker](/en/guides/quote-tracker-small-business-ai-2026/), and to alert the team, [connect Slack](/en/guides/connect-slack-ai-tool/) and [connect Brevo](/en/guides/connect-brevo-api-ai-tool/).

## Try it with your tool

Give this message to your AI, then ask it to connect Typeform. 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. [Typeform, Personal access token](https://www.typeform.com/developers/get-started/personal-access-token/), 2026-11-18
2. [Typeform, OAuth 2.0 scopes](https://www.typeform.com/developers/get-started/scopes/), 2026-11-18
3. [Typeform, Get started](https://www.typeform.com/developers/get-started/), 2026-11-18

## Questions

### How do you get a Typeform API token?

In Typeform, open the menu next to your name, then Account and Personal tokens. Click Generate a new token, name it, choose the scopes, then Generate token (source 1).

### Which scopes should you give the Typeform token?

To read responses, forms:read and responses:read are enough. A token with no write scope can neither edit nor delete your forms (source 2).

### Does my AI see the Typeform token?

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

### My Typeform responses are stored in Europe, is that different?

Yes, the API address changes: api.eu.typeform.com instead of api.typeform.com. Tell your AI when it declares the connection (source 3).

### What happens if the token ends up on GitHub?

Typeform is a GitHub secret scanning partner: a token pushed to a repository is detected and disabled. On while, it is never in the code (source 1).
