> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatflows.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer API Keys

> Create API keys so your own software can connect to your ChatFlows workspace safely, with only the permissions you allow.

An API token lets another app connect to your workspace. After you create a token, that app can use it to access your data and perform actions based on the permissions you allow.

Find it under **Setup → Developer API Keys**.

## Creating a token

**1. Name it and set permissions**

Click **Add Token**. Enter a name so you can identify the token later, such as Website or Zapier, then choose only the permissions the app needs.

![The Add API Token form with a Name field, the Base URL with a copy button, and grouped scope checkboxes for account and contacts](https://docs.chatflows.io/core-setup/img/api-token-form.png)

Image shows the Add API Token form.

**2. Set an expiry date (optional)**

Choose when the token should expire, or leave it empty so it never expires.

**3. Copy the token**

After you create the token, copy it and save it somewhere safe — it's shown only once and can't be viewed again.

## Your tokens

The list shows each token's **name**, **permissions**, **last used date**, **expiry date**, and **created date**. If a token never expires, it shows Never. You can also search by token name.

![The token list with two tokens showing their scopes, last used date, expiry and created date, plus API Docs, Postman Collection and Add Token buttons](https://docs.chatflows.io/core-setup/img/api-token.png)

Image shows the Developer API Keys page.

At the top of the page, you'll find two helpful buttons:

* **API Docs** — View the complete API documentation.
* **Postman Collection** — Download ready-to-use API requests for Postman.

## Regenerate or revoke

Open a token's `⋮` menu for its two actions:

* **Regenerate** — Generates a new token to replace the current one. The old token stops working right away, so update your app with the new one.
* **Revoke** — Permanently deletes the token. Any app using it will stop working immediately.

> [!WARNING]
>
> You cannot change a token's name or permissions after creating it. If you need different permissions, create a new token and revoke the old one.

## Using your token

Send the token with every request, in the `Authorization` header:

```text theme={null}
Authorization: Bearer YOUR_API_TOKEN
```

Send it to the **Base URL** shown on the Add API Token form, followed by the endpoint path. For example:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://app.chatflows.io/api/v1/contacts
```

## What's next

> [card] [API Overview](https://docs.chatflows.io/overview.md)
>
> The base URL, pagination, and every available endpoint.

> [card] [Webhooks](https://docs.chatflows.io/settings/webhooks.md)
>
> Get events sent to your own system as they happen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.