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

# Integrations & API Keys

> Generate and manage API keys and configure external integrations from [Management] > [Integrations] in the console.

## Overview

The **\[Management]** > **\[Integrations]** menu is where you configure all external Adrop integrations.

* **API Keys**: used for Open API calls and for decrypting rewarded ad SSV callbacks
* **Reward Ad SSV**: configure the server URL that receives reward-completion callbacks — see [Reward Ad SSV](/integrations/ssv)

The Integrations menu is accessible only to project members with the **owner** role.

***

## Generating an API Key

<Steps>
  <Step title="Open the Integrations menu">
    Go to **\[Management]** > **\[Integrations]** in the console.
  </Step>

  <Step title="Enter key information">
    In the **API Keys** section, click **\[Create API Key]** and fill in the following:

    | Field        | Description                                                                                      |
    | ------------ | ------------------------------------------------------------------------------------------------ |
    | **Key Name** | A name to identify the key's purpose (e.g., "Report Integration"). Must be at least 1 character. |
    | **Scope**    | Select at least one scope. Calls are limited to the granted scopes.                              |
  </Step>

  <Step title="Copy and store the key">
    Copy the generated API key and store it securely.

    <Warning>
      The API key is shown **only once** at creation. It cannot be retrieved afterward, so make sure to copy and store it securely.
    </Warning>
  </Step>
</Steps>

### Available Scopes

| Scope            | Description                                      |
| ---------------- | ------------------------------------------------ |
| `report:read`    | Query campaign reports and backfill revenue data |
| `campaign:read`  | Read campaign information                        |
| `campaign:write` | Create and modify campaigns                      |
| `webhook:read`   | Read webhook callback data                       |
| `webhook:write`  | Send webhook events                              |
| `auth:delegate`  | Create delegate authentication codes             |

<Note>
  The currently available Open API endpoint is the [Report API](/integrations/reports). The scope list may appear partial depending on your console configuration.
</Note>

***

## Calling the Open API

### Basic Information

| Item           | Value                        |
| -------------- | ---------------------------- |
| Base URL       | `https://lake.adrop.io`      |
| Protocol       | HTTPS                        |
| Authentication | API Key (`x-api-key` header) |

### Authentication

Include the `x-api-key` header in every API request.

```bash theme={null}
curl -X POST https://lake.adrop.io/report \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{...}'
```

<Warning>
  Do not share your API key externally. If a key is exposed, revoke it immediately and generate a new one.
</Warning>

***

## Managing API Keys

### Viewing Keys

View issued API keys in the **API Keys** section of the **Integrations** menu.

| Column       | Description                                                       |
| ------------ | ----------------------------------------------------------------- |
| **Key Name** | Name entered at creation                                          |
| **API Key**  | Only the prefix (e.g., `adrop_7kF2`) is shown; the rest is masked |
| **Scope**    | Number of granted scopes (hover for full list)                    |
| **Created**  | Key creation date                                                 |

### Revoking Keys

Revoke unused keys from the row menu using **\[Revoke]**.

<Warning>
  Revoked API keys are blocked immediately. API calls using the revoked key will fail. Verify that no active integrations are using the key before revoking.
</Warning>

<Note>
  API keys that are connected to a **Rewarded Ad SSV** cannot be revoked. Change the API key in the SSV or delete the SSV configuration, then try again.
</Note>

***

## Related

<CardGroup cols={2}>
  <Card title="Reward Ad SSV" icon="shield-check" href="/integrations/ssv">
    Register the SSV callback URL that receives reward-completion events and decrypt the payload
  </Card>

  <Card title="Report API" icon="chart-line" href="/integrations/reports">
    Query campaign performance and backfill revenue data via API
  </Card>
</CardGroup>