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

# API Keys

> Create and manage API keys for the LetterBucket Public API

API keys let external tools and integrations manage your newsletter through the [LetterBucket Public API](/api/introduction) — for example creating subscribers from your own website or syncing your audience with other services.

Manage your keys at **Settings → Newsletter → API Keys**.

<Info>
  API access is a plan-gated feature and requires settings management permission. If the API Keys section appears disabled, check your plan or your role in the newsletter.
</Info>

<Note>
  These keys are for the Public API. They're different from the AI provider keys under **Settings → Profile → API Keys**, which connect your own AI models to the [writing assistant](/settings/ai-providers).
</Note>

## The API Keys page

* **API Base URL** — the base URL for all API requests to this newsletter, with a **Copy** button.
* **Documentation** — a shortcut to the [API reference](/api/introduction).
* **API Keys** — your list of keys, showing how many active keys you have out of your maximum.

## Creating a key

1. Click **Create API Key**.
2. Give it a **name** that identifies the integration (e.g. "My Integration").
3. The new key is shown **only once** — copy it and store it somewhere safe.

Each key is scoped to the newsletter it was created in: it cannot read or modify data from any other newsletter.

## Revoking and deleting keys

Each key in the list has two actions:

| Action         | Effect                                                                   |
| -------------- | ------------------------------------------------------------------------ |
| **Revoke Key** | Deactivates the key — any integration using it stops working immediately |
| **Delete Key** | Removes the key from your list entirely                                  |

<Warning>
  Treat API keys like passwords. If a key leaks, revoke it immediately and create a new one.
</Warning>
