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

# API Keys

> Create and manage API keys to integrate external services with your Jelou account

API keys allow you to authenticate requests to the Jelou API from external applications or services. With them you can send messages, manage campaigns, query conversations, and more, programmatically.

## Accessing API Keys

To manage your API keys, go to **Settings** > **API Keys** in the side menu.

<Frame>
  <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/settings-sidebar.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=ae70ce82a0d0a9c840af8a93191ad784" alt="Settings side menu showing the API Keys option under the General section" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/settings-sidebar.png" />
</Frame>

You will see a table with all existing API keys in your account, including:

* **Key**: Partially hidden identifier of the key
* **Creation date**: When it was generated
* **Actions**: Available options for each key

<Frame>
  <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/api-keys-list.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=ae8a8c68e75a94df0134eee969ae0f4b" alt="API Keys table view showing existing keys with their creation date and available actions" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/api-keys-list.png" />
</Frame>

## Create an API key

<Steps>
  <Step title="Start the creation">
    Click the **Create** button located in the upper right corner of the page.
  </Step>

  <Step title="Confirm the creation">
    A confirmation dialog will appear. Click **Create** to generate the new key.

    <Frame>
      <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/create-api-key-modal.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=6dcaa96abbf0f9a0017d1b81e61a0bcd" alt="Confirmation dialog to create a new API key" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/create-api-key-modal.png" />
    </Frame>
  </Step>

  <Step title="Copy your key">
    The generated key will be displayed on screen. Use the copy button to save it to your clipboard.

    <Frame>
      <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/api-key-created.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=8c124f1e1fbb8b3cc7bd3babc0ac7519" alt="Dialog showing the newly created API key with a copy button and single-visibility warning" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/api-key-created.png" />
    </Frame>

    <Warning>
      The key is only shown **once**. Copy it and store it in a safe place before closing the dialog. If you lose it, you will need to create a new one.
    </Warning>
  </Step>
</Steps>

## Delete an API key

To delete a key you no longer need, click the delete icon (trash can) in the **Actions** column of the corresponding key.

A confirmation dialog will be shown before proceeding.

<Frame>
  <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/delete-api-key-modal.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=1536199cea71c2ac4a7d573bd0c99632" alt="Confirmation dialog to delete an API key, warning that the action cannot be undone" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/delete-api-key-modal.png" />
</Frame>

<Warning>
  Deleting an API key is an **irreversible** action. Any integration using that key will stop working immediately. Verify that no active service depends on the key before deleting it.
</Warning>

## Use your API key

Include the API key in the `x-api-key` header of your HTTP requests:

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://gateway.jelou.ai/platform/v1/company/{companyId} \
    --header 'x-api-key: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://gateway.jelou.ai/platform/v1/company/{companyId}",
    {
      headers: {
        "x-api-key": "YOUR_API_KEY",
      },
    }
  );
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://gateway.jelou.ai/platform/v1/company/{companyId}",
      headers={"x-api-key": "YOUR_API_KEY"},
  )
  ```
</CodeGroup>

<Tip>
  Check the [API reference](/api/introduction) to see all available endpoints.
</Tip>

## Best practices

* **Do not share keys** in public repositories or messages. Use environment variables to store them.
* **Rotate your keys periodically**. Create a new key, update your integrations, and delete the old one.
* **Use one key per integration**. If a key is compromised, you can revoke it without affecting other services.
