How to Launch a Campaign with the API

This page walks through launching a banner, native or video campaign through the Eskimi DSP API, from the creative to the first report. It is for developers and advertisers who already have an access token; if you don't, start with How to Use the API . 
 Every request below needs the header Authorization: Bearer {ACCESS_TOKEN} . All parameters are described in the API documentation: https://dsp-api.eskimi.com/docs/api/v1/ 
 1. Look Up the IDs You Need 
 Campaign settings use IDs, not names. Get them from the reference data endpoints first, for example: 
 
 Countries: GET /country/get . Campaigns use the two-letter lowercase code, e.g. lt . 
 Operators: GET /operators/get/{country} 
 Device types, brands and operating systems: GET /device/types/get , /device/brands/get , /device/oses/get 
 Exchanges and sites: GET /exchanges/get , GET /sites/get 
 
 2. Create a Creative Set 
 POST /creative/sets/create with advertiserId and a title . The response returns the creative set ID. 
 3. Create the Creative and Add Its Assets 
 First create the creative: POST /creative/create with advertiserId , creativeSetId and a title . The response returns the creative ID. Then add its assets, depending on the campaign type: 
 a. Banner 
 POST /creative/banner/upload with advertiserId , creativeId and creativeFile : a base64-encoded zip of .png, .jpg or .gif files. 
 b. Native 
 POST /creative/native/upload with advertiserId , creativeId and: 
 
 iconFile , imageMainFile and image600x600File : each a base64-encoded zip with one .png, .jpg or .gif image. 
 content : the ad text. content.title is required; description, call to action, sponsor name, price, rating and the other text fields are optional. 
 
 c. Video 
 Video creatives cannot be uploaded through the API. Upload them to a creative set in the DSP, then use that creative set's ID in step 4. 
 4. Create the Campaign 
 Use the endpoint for the campaign type. All three take the same fields: 
 
 Banner: POST /campaign/banner/create 
 Native: POST /campaign/native/create 
 Video: POST /campaign/video/create 
 
 To submit the campaign for review, send at least: 
 
 Field Example 
 
 advertiserId , name 1234 , "LT_Spring_Sale_Banner" 
 dates {"from": "2026-11-01", "to": "2026-11-30"} 
 country "lt" 
 budget {"type": "total", "amount": 5000, "pacing": 1} (pacing: 1 = Even, 0 = None) 
 bid Within the advertiser's minimum and maximum bid 
 creativeSetIds [5678] . The sets must hold creatives of the campaign's type, e.g. video creatives for a video campaign 
 clickUrl , adDomain "https://example.com/sale" , "example.com" 
 
 
 Add targeting with the IDs from step 1. The optional channel field sets where the campaign runs: 1 display (the default), 2 in-game, 4 DOOH. The response returns the campaign ID. 
 Not ready to submit yet? Send "status": "draft" . A draft needs only advertiserId and name , and is not reviewed until it is completed. 
 5. Review and Approval 
 A submitted campaign has the status pending until it is reviewed. Check it with GET /campaign/status/get/{campaignId} . The possible statuses are pending, ready, active, stopped, rejected, daily_cap, limit_budget, expired_date and deleted. For what is reviewed and how long it takes, see Campaign Approval for Self-Service Accounts . 
 6. Start, Stop and Optimise 
 
 Start or stop the whole campaign: POST /campaign/start/{campaignId} , POST /campaign/stop/{campaignId} 
 Start or stop delivery on single exchanges, creatives, operating systems, browsers, operators, sites or apps, placements or packages: POST /optimisation/action , up to 10 campaigns per call. Each option must be enabled for the advertiser. 
 Change only the budget pacing: POST /campaign/{campaignId}/pacing with {"pacing": 1} (Even) or {"pacing": 0} (None). Not available for campaigns with a daily budget. 
 
 7. Pull the Report 
 Use GET /report/campaigns/get for daily delivery, the split reports (sites, exchanges, creatives and others) for detail, and GET /report/totals for period totals including reach. 
 Summary 
 Look up IDs, create the creative set and creative, add its assets (video in the DSP), create the campaign, wait for review, then manage and report on it through the API. To try each call without writing code, use the API Postman Template .