Skip to main content

​
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

1

Open the Integrations menu

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

Enter key information

In the API Keys section, click [Create API Key] and fill in the following:
FieldDescription
Key NameA name to identify the key’s purpose (e.g., “Report Integration”). Must be at least 1 character.
ScopeSelect at least one scope. Calls are limited to the granted scopes.
3

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

ScopeDescription
report:readQuery campaign reports and backfill revenue data
campaign:readRead campaign information
campaign:writeCreate and modify campaigns
webhook:readRead webhook callback data
webhook:writeSend webhook events
auth:delegateCreate 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

ItemValue
Base URLhttps://lake.adrop.io
ProtocolHTTPS
AuthenticationAPI 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.
ColumnDescription
Key NameName entered at creation
API KeyOnly the prefix (e.g., adrop_7kF2) is shown; the rest is masked
ScopeNumber of granted scopes (hover for full list)
CreatedKey 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

Register the SSV callback URL that receives reward-completion events and decrypt the payload

Report API

Query campaign performance and backfill revenue data via API