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

# Provider keys

> Add your own key with a provider, so enrichment columns can look up rows on your own account with it.

Add the key you already have with a provider, and your waterfall columns can use it. A row your key answers costs a small fee here, and the provider bills your own account for the lookup.

![The Provider keys tab with no keys yet, a Connect a key button, and the order for new waterfall columns set to Recommended.](https://mintcdn.com/oneprofile/2cPrtXzIvQgrUV7C/images/integrations/provider-keys.png?fit=max\&auto=format\&n=2cPrtXzIvQgrUV7C\&q=85\&s=a55ffa6ed0034c566d04edef7f907e7f)

The Provider keys tab in Connections.

## Add a key

**1. Open Provider keys**

Open [Connections](https://app.getoneprofile.ai/settings/connections/provider-keys) and click the **Provider keys** tab, then **Connect a key**.

**2. Pick the provider**

Choose the provider from the list. Its form says where to find the key in that provider's own settings.

**3. Paste the key and test it**

Paste the key and click **Test and connect**. The key is checked with the provider before it is saved.

> [!TIP]
>
> The key's row reads **Working**, with when it was last checked and, where the provider reports it, how many of its credits are left.

## Keep a key working

A key that stops working shows **Not working** or **Out of credits** in its **Health** column. The tab says what that means for your rows. Rows that skipped the provider can be run again with **Run failed rows** once the key works.

The ⋯ at the end of a key's row holds three actions. **Check again** after you have fixed the key with the provider, **Replace key** to paste a new one, and **Remove** to take it away.

Everyone in the workspace gets an email when a key stops working, runs out of credits, or runs low, even one saved that way. Each person can switch these off under **Provider key stopped working** and **Provider key running low** in [Notifications](https://docs.getoneprofile.ai/settings/notifications.md). A Slack rule there posts them to a channel.

## Choose the order new columns start with

**Order for new waterfall columns** sets the order a new waterfall column starts with, and a column you already made keeps its own. On a free plan, new columns start on **Recommended**. See [Choose providers](https://docs.getoneprofile.ai/enrich/choose-providers.md) to change one column.

## Good to know

> [accordion] What does a row on my key cost?
>
> The fee shown in the connect form, charged only when your key answers the row. The lookup itself is billed by the provider to your account.

> [accordion] What happens when I remove a key?
>
> A **Custom** column that pays that provider with the key keeps its order, and its rows skip the provider until a key is added again. A column on **Your keys first** asks that provider with credits instead.

> [accordion] Who can add or remove a key?
>
> Anyone in the workspace. Every change is recorded with who made it.

> [accordion] Can the AI Assistant add a key for me?
>
> No. A key works like a password, so only you add or replace one, on this tab. The AI Assistant can list your keys, check one again, remove one when you approve it, set the order new columns start with, and set a column's providers.

> [accordion] Why is Connect a key greyed out?
>
> Provider keys come with paid plans. On a free plan, the tab offers **Upgrade** instead.

> [accordion] Is my key shown again after I save it?
>
> No. It is stored encrypted and sent only to its provider. The tab shows its last few characters so you can tell keys apart.

## Next steps

> [card] [Choose providers](https://docs.getoneprofile.ai/enrich/choose-providers.md)
>
> Pick which providers a column asks, in what order, and who pays.

> [card] [Connect a tool](https://docs.getoneprofile.ai/integrations/connect-a-tool.md)
>
> Connect a CRM or another tool to the workspace.


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