> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.anghello.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Using API keys


API keys let you access your Anghello organization's data from your own applications or scripts. This guide shows you how to create and manage your API keys.

**Audience:** Administrators
**Application:** Admin (app.anghello.co)
**Estimated time:** 5 minutes

## Before you start

- You need an **Administrator account** on Anghello
- The **"API & Webhooks"** add-on must be included in your subscription

## Creating an API key

**1. Open the API Keys page**

In the left-hand menu, click the box showing your first name at the very bottom, then click **API Keys**.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/0/a/6/20a671ba57d61a00/screenshot15xpostspark2026-03-_1tajpr6.png)

**2. Create a key**

Click the **Generate API Key** button. A window asks you to name your key (for example "CRM integration" or "Export script").

**3. Copy the key**

Your API key is generated and displayed. It has the format `ak_xxxxxxxxxxxx`.

|| **Important:** Copy the key immediately and keep it somewhere safe. For security reasons, the full value can no longer be shown after this step.

## Managing your keys

The key list shows:

| Column        | Description                                                            |
| ------------- | ---------------------------------------------------------------------- |
| **Name**      | The name you gave the key                                              |
| **Value**     | The masked key (click the eye icon to reveal it temporarily)          |
| **Created**   | The creation date                                                     |
| **Actions**   | Copy the key or revoke it                                             |

## Revoking a key

If a key is compromised or no longer used:

**1.** Click **Revoke** to the right of the key concerned.

**2.** Confirm the revocation.

|| **Important:** Revocation is immediate and irreversible. Every application using this key will stop working. Create a new key if needed.

## Good to know

> 💡 **Tip:** Use explicit names for your keys ("Salesforce integration", "Weekly report") so you can easily tell which service uses which key.

> 💡 **Tip:** Create one key per application or service. If a key is compromised, you can revoke it without affecting your other integrations.

|| **Important:** Never share your API keys in public source code or emails. Treat them like passwords.

## Troubleshooting

| Problem                          | Solution                                                                                                       |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| The API Keys page doesn't appear | The "API & Webhooks" add-on isn't included in your subscription. Contact our team.                            |
| My key no longer works           | Check that it hasn't been revoked. Create a new key if needed.                                                 |
| I lost my key                    | Create a new key and update your applications. An existing key's value can't be recovered.                    |

If the problem persists, contact our team via the chat at the bottom right of your screen, or at support@anghello.co.