> ## 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.

# API-key providers

> Every API-key provider authsome ships out of the box. 31 services with long-lived secrets behind a secure browser bridge.

Authsome ships with 31 bundled API-key providers. Each is a service with a single long-lived secret rather than an OAuth flow. Authsome collects the key through a local browser form (or masked terminal input on headless machines) and stores it encrypted in the vault.

## Bundled API-key providers

| Provider                                                         | Display name        | Host                         |
| ---------------------------------------------------------------- | ------------------- | ---------------------------- |
| [ahrefs](/integrations/api-key/ahrefs)                           | Ahrefs              | `api.ahrefs.com`             |
| [apollo](/integrations/api-key/apollo)                           | Apollo              | `api.apollo.io`              |
| [ashby](/integrations/api-key/ashby)                             | Ashby               | `api.ashbyhq.com`            |
| [beehiiv](/integrations/api-key/beehiiv)                         | Beehiiv             | `api.beehiiv.com`            |
| [brevo](/integrations/api-key/brevo)                             | Brevo               | `api.brevo.com`              |
| [buffer](/integrations/api-key/buffer)                           | Buffer              | `api.bufferapp.com`          |
| [calendly](/integrations/api-key/calendly)                       | Calendly            | `api.calendly.com`           |
| [clearbit](/integrations/api-key/clearbit)                       | Clearbit            | `api.clearbit.com`           |
| [dub](/integrations/api-key/dub)                                 | Dub.co              | `api.dub.co`                 |
| [g2](/integrations/api-key/g2)                                   | G2                  | `api.g2.com`                 |
| [hunter](/integrations/api-key/hunter)                           | Hunter              | `api.hunter.io`              |
| [instantly](/integrations/api-key/instantly)                     | Instantly           | `api.instantly.ai`           |
| [intercom](/integrations/api-key/intercom)                       | Intercom            | `api.intercom.io`            |
| [keywords-everywhere](/integrations/api-key/keywords-everywhere) | Keywords Everywhere | `api.keywordseverywhere.com` |
| [klaviyo](/integrations/api-key/klaviyo)                         | Klaviyo             | `a.klaviyo.com`              |
| [lemlist](/integrations/api-key/lemlist)                         | Lemlist             | `api.lemlist.com`            |
| [livestorm](/integrations/api-key/livestorm)                     | Livestorm           | `api.livestorm.co`           |
| [mailchimp](/integrations/api-key/mailchimp)                     | Mailchimp           | `api.mailchimp.com`          |
| [mention-me](/integrations/api-key/mention-me)                   | Mention Me          | `mention-me.com`             |
| [openai](/integrations/api-key/openai)                           | OpenAI              | `api.openai.com`             |
| [optimizely](/integrations/api-key/optimizely)                   | Optimizely          | `api.optimizely.com`         |
| [postmark](/integrations/api-key/postmark)                       | Postmark            | `api.postmarkapp.com`        |
| [resend](/integrations/api-key/resend)                           | Resend              | `api.resend.com`             |
| [rewardful](/integrations/api-key/rewardful)                     | Rewardful           | `api.getrewardful.com`       |
| [savvycal](/integrations/api-key/savvycal)                       | SavvyCal            | `api.savvycal.com`           |
| [semrush](/integrations/api-key/semrush)                         | SEMrush             | `api.semrush.com`            |
| [sendgrid](/integrations/api-key/sendgrid)                       | SendGrid            | `api.sendgrid.com`           |
| [tolt](/integrations/api-key/tolt)                               | Tolt                | `api.tolt.com`               |
| [typeform](/integrations/api-key/typeform)                       | Typeform            | `api.typeform.com`           |
| [wistia](/integrations/api-key/wistia)                           | Wistia              | `api.wistia.com`             |
| [zapier](/integrations/api-key/zapier)                           | Zapier              | `api.zapier.com`             |

For all providers (OAuth and API-key) in one CLI view:

```bash theme={null}
authsome list
```

## How the API-key flow works

There is no OAuth dance. The flow is:

<Steps>
  <Step title="Run the login">
    ```bash theme={null}
    authsome login openai
    ```
  </Step>

  <Step title="Paste the key into the browser form">
    Authsome opens `http://127.0.0.1:7998` with a masked input. The key never goes through the shell.
  </Step>

  <Step title="Pattern validation (where applicable)">
    Some providers ship a regex (`key_pattern`). If your input doesn't match, authsome rejects it with a hint.
  </Step>

  <Step title="Encrypted store">
    The key is encrypted in the active vault and written to the vault.
  </Step>
</Steps>

On a headless machine without a graphical session, authsome falls back to masked terminal input via `getpass`. See [Use API keys](/guides/use-api-keys).

## Use the key

### Through the proxy

```bash theme={null}
authsome run -- python my_agent.py
```

Authsome sets a placeholder like `OPENAI_API_KEY=authsome-proxy-managed` in the child's environment so the SDK initializes. The real key is added to outbound requests at the proxy layer. The child process never sees the actual key.

### As an environment variable

```bash theme={null}
eval "$(authsome export openai --format env)"
```

`export` prints `KEY=value` lines suitable for shell sourcing. The names come from each provider's `export.env` map.

### From Python

Run under the proxy (recommended) or export into the environment before launching your script. See [Python library](/reference/python-library).

## Add an API-key provider

For a service authsome doesn't bundle (Anthropic, Stripe, Twilio, and many others):

1. Find the header shape (`Authorization: Bearer ...`, `X-API-Key: ...`, etc.).
2. Write a JSON definition. See [Custom providers](/guides/custom-providers) for the template.
3. `authsome register ./<name>.json`.

## What's next

<Columns cols={2}>
  <Card title="Use API keys" icon="key" href="/guides/use-api-keys">
    The full API-key login walkthrough.
  </Card>

  <Card title="OAuth providers" icon="right-to-bracket" href="/integrations/oauth/index">
    The other half of the bundled set.
  </Card>

  <Card title="Custom providers" icon="puzzle-piece" href="/guides/custom-providers">
    Add an API-key provider authsome doesn't ship.
  </Card>

  <Card title="Run agents with the proxy" icon="shield-halved" href="/guides/run-agents-with-proxy">
    Inject API keys into outbound requests without exposing them.
  </Card>
</Columns>