List advertiser campaigns with pagination. Filter by folder, status, type, date range, or search query.

Create a new advertiser campaign. Required: type, name, url, folderId, pricingModel, bid, dailyBudget.

Update an existing campaign (read-modify-write). Fetches current state, merges your changes, sends full payload. Pass only the fields you want to change. Uses same field names as create. For status changes use set_campaign_status instead.

Set status for multiple campaigns. Pass comma-separated IDs and status: active, paused, or archived.

Update bid for a single campaign without sending the full campaign payload. Faster and safer than kadam_adv_update_campaign when only the bid needs changing. If countries omitted, keeps the campaign's current country targeting. Note: this endpoint only updates bids for countries already configured on the campaign; it does not add new countries.

Update bids for multiple campaigns at once. All specified campaigns receive the same bid. Much faster than updating campaigns one by one. IMPORTANT: all campaigns in the batch must share the same pricing model (all CPC/CPM or all CPA). Mixing CPC and CPA campaigns will cause a validation error. Countries are required — the backend rejects empty country lists.

Set per-site (zone) bids for campaigns. Allows bid adjustments on individual publisher sites. Bid can be a number ('0.05'), a multiplier ('x1.5' to multiply base bid), or '0' to remove the site bid. This is idempotent — calling with the same values has no additional effect.

List advertiser campaign folders with pagination. Optional search by name.

Create a new campaign folder.

Update campaign folder settings: budgets and distribution.

List advertiser audiences with pagination. Filter by search query, sort by field and order.

Get a single audience by ID. Returns type-specific details: tracking code for pixel/s2s, campaign links for stat, linked audiences for s2s.

Create a new audience. Types and required fields: • audience_code (pixel) — name, expireDays. Optional: createFingerprint (creates linked FP audience). • audience (stat/campaign data) — name, expireDays, campaignIds (comma-separated), plus at least one of: hasClicks, hasConversions, hasHolds, hasRejects. • s2s — name, expireDays, linkedAudienceIds (comma-separated IDs of pixel/fingerprint audiences). • fingerprint — cannot be created directly; set createFingerprint=true on pixel or stat audience.

Update an existing audience (read-modify-write). Fetches current state, merges your changes, sends full payload. Type cannot be changed. Pass only the fields you want to change.

Permanently delete an audience. Requires confirm=true for safety.

List advertiser creatives with pagination. Filter by campaign, status, or search query.

Create a new creative for a campaign. Accepts both URLs (http/https) and local file paths for images/video.

Campaign type determines required fields:

• Push / In-Page Push: title, text, url, imageUrl (icon 192x192+), mainImageUrl (492x328+)

• Native: title, url, imageUrl (icon 500x500+), mainImageUrl (492x328+)

• Banner: url, imageUrl (exact banner size), sizeId (use kadam://reference/creative-formats for valid sizes)

• Video: title, url, videoUrl (MP4 file)

• Popunder: does NOT support separate creatives (campaign URL = ad)

Image/video sources: URL (https://...) or local path (/Users/.../image.png, ~/Downloads/banner.jpg).

Update an existing creative (read-modify-write). Fetches current state, merges your changes, sends full payload. Pass only the fields you want to change. For image changes, create a new creative instead.

Set status for multiple creatives. Pass comma-separated IDs and status: active, paused, or archived.

Lists financial operations (deposits, charges, refunds). Use to check account balance, recent transactions, and spending history.

Unified advertiser statistics. Use reportType to select: 'custom' (default) for full report builder, 'sites' for per-site breakdown, 'conversions' for individual conversion event log. For custom reports use human-readable names like 'spend,clicks,impressions,ctr' for metrics and 'day,campaign,country' for groupBy.