ironSource

ironSource (rebranded as Unity LevelPlay in 2023) uses a two-credential system: a static secret key tied to your account, and a refresh token generated via their OAuth endpoint. adduck handles token refresh automatically.

Required credentials

Field	Description
secretKey	Your ironSource account secret key. Found in the ironSource dashboard under Account settings. This is a long-lived credential that doesn't expire.
refreshToken	An OAuth refresh token with reporting and campaign management scopes. Generated via the ironSource token endpoint or the adduck login wizard.

Step 1: Get your secret key

Go to My Account (top right corner) then select API. Your secret key is listed on this page. Copy it.

Step 2: Get a refresh token

The easiest way is via the adduck login wizard:

adduck auth login ironsource

The wizard uses your secret key (which you enter first) to authenticate against the ironSource token endpoint and retrieve a refresh token automatically.

To do it manually, call the ironSource token endpoint with your username and secret key:

curl -X GET \
  "https://platform.ironsrc.com/partners/publisher/auth?secretkey=YOUR_SECRET_KEY" \
  -H "secretkey: YOUR_SECRET_KEY"

Use the token value from the response as your refreshToken.

Manual config

{
  "accounts": {
    "ironsource": {
      "secretKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "refreshToken": "eyJhbGciOiJSUzI1NiJ9..."
    }
  }
}

Token expiry

ironSource refresh tokens expire after 30 days. adduck warns you at 7 days remaining. When a token expires, run adduck auth login ironsource to regenerate it -- the wizard re-derives the token from your secret key automatically, so you only need the secret key stored.

Your secret key doesn't expire as long as you don't rotate it manually.

API versions

adduck uses:

Reporting API v3 for spend data and campaign stats
Campaign Management API v2 for pause, resume, and budget changes

Both are the current versions as of 2026. The older v1 reporting API was sunset in late 2024.

ironSource vs Unity Ads

After the Unity-ironSource merger, both platforms run independently with separate APIs and dashboards. If you advertise on both, connect them separately:

adduck auth login ironsource
adduck auth login unity

adduck spend will show rows for both platforms side by side.

Testing the connection

adduck spend --platform ironsource --days 7