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

# Beehiiv

> Store and use your Beehiiv API key with authsome. Local encrypted vault, proxy injection, no key in the agent's environment.

Beehiiv uses a long-lived API key. Authsome stores the key encrypted in the local vault, injects it at request time through the proxy, and keeps it out of shell history, process listings, and environment dumps.

## At a glance

|                    |                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------ |
| Provider name      | `beehiiv`                                                                                              |
| Display name       | Beehiiv                                                                                                |
| Auth type          | API key                                                                                                |
| Header             | `Authorization: Bearer <key>`                                                                          |
| Proxy host         | `api.beehiiv.com`                                                                                      |
| Env var            | `BEEHIIV_API_KEY`                                                                                      |
| Where to get a key | [https://app.beehiiv.com/settings/integrations/api](https://app.beehiiv.com/settings/integrations/api) |

## Get a key

Create an API key in the Beehiiv dashboard at [https://app.beehiiv.com/settings/integrations/api](https://app.beehiiv.com/settings/integrations/api).

## Log in

```bash theme={null}
authsome login beehiiv
```

A local browser form opens at `http://127.0.0.1:7998`. Paste the key into the masked input and submit.

On a headless machine without a graphical session, authsome falls back to masked terminal input via `getpass`. The browser bridge is skipped automatically when no display is available.

Verify:

```bash theme={null}
authsome get beehiiv --field status
# → connected
```

## Use the key

Run the agent under the proxy (recommended).

<CodeGroup>
  ```bash Proxy (recommended) theme={null}
  authsome run -- python my_agent.py
  ```

  ```bash Environment theme={null}
  eval "$(authsome export beehiiv --format env)"
  echo $BEEHIIV_API_KEY
  ```
</CodeGroup>

Under the proxy, authsome sets `BEEHIIV_API_KEY=authsome-proxy-managed` in the child's environment and injects the real key into outbound requests to `api.beehiiv.com`. The child process never sees the actual value.

## Multiple keys

Pass `--connection <name>` on `login` and on every read command to keep two or more accounts on the same provider side by side. See [Multiple connections per provider](/guides/multiple-connections) for the full pattern.

```bash theme={null}
authsome login beehiiv --connection personal
authsome login beehiiv --connection team
```

## Rotate or remove the key

```bash theme={null}
authsome login beehiiv --force          # rotate
authsome logout beehiiv                  # remove local credential
authsome remove beehiiv                  # remove all local state for the provider
```

API-key providers have no revocation endpoint, so `revoke` and `remove` are equivalent for Beehiiv.

## Override the bundled definition

```bash theme={null}
authsome inspect beehiiv > ~/.authsome/providers/beehiiv.json
# edit fields
authsome list   # source now shows "custom" for beehiiv
```

## What's next

<Columns cols={2}>
  <Card title="Run agents with the proxy" icon="shield-halved" href="/guides/run-agents-with-proxy">
    Keep the key out of the agent's environment entirely.
  </Card>

  <Card title="Multiple connections per provider" icon="users" href="/guides/multiple-connections">
    Keep two or more keys on the same provider side by side.
  </Card>

  <Card title="API-key providers" icon="key" href="/integrations/api-key/index">
    All bundled API-key providers.
  </Card>
</Columns>