Integrations & API Keys - Ad Control Help Center

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

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

Generating an API Key

Open the Integrations menu

Go to [Management] > [Integrations] in the console.

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.

Copy and store the key

Copy the generated API key and store it securely.

The API key is shown only once at creation. It cannot be retrieved afterward, so make sure to copy and store it securely.

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

The currently available Open API endpoint is the Report API. The scope list may appear partial depending on your console configuration.

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.

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

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

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

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.

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.

Reward Ad SSV

Report API

Query campaign performance and backfill revenue data via API

​Overview

​Generating an API Key

​Available Scopes

​Calling the Open API

​Basic Information

​Authentication

​Managing API Keys

​Viewing Keys

​Revoking Keys

​Related

Reward Ad SSV

Report API

Overview

Generating an API Key

Available Scopes

Calling the Open API

Basic Information

Authentication

Managing API Keys

Viewing Keys

Revoking Keys

Related