Launch a draft campaign
const url = 'https://ads.wortise.com/api/public/v1/campaigns/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/launch';const options = {method: 'POST', headers: {'x-api-key': '<x-api-key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://ads.wortise.com/api/public/v1/campaigns/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/launch \ --header 'x-api-key: <x-api-key>'Launches a draft campaign: stamps its pricing, debits the organization balance and syncs it to the ad server. Answers 409 when the campaign is not a draft, and 412 when it is not ready to launch (a missing field, a price below the organization minimum, an ad group without creatives, ad group budgets that do not add up to the campaign budget) or the balance does not cover the cost.
Requires the campaigns:launch scope.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Draft campaign UUID.
Responses
Section titled “Responses”The launched campaign.
object
object
Impressions (CPM) or clicks (CPC) targeted.
Unit price in USD (CPM or CPC) to external service-ads. Only for a campaign without ad groups
object
object
object
object
object
Only explicitly requested targeting exclusions.
object
object
object
object
object
object
object
object
object
E.g: “1”, “20”.
object
object
object
object
Exact inventory locations or geographic areas to target.
object
object
object
object
object
object
object
object
object
object
object
Optional demographic filters. Age codes are ranges: -18=under 18, 18=18–24, 25=25–34, 35=35–44, 45=45–54, 55=55–64, 65=65+. Adults 18+ requires all six adult ranges, not just 18. Gender ?? means unknown, not all genders; omit gender on creation or use [] on update for unrestricted gender.
object
object
object
object
object
object
object
object
E.g: “1”, “20”.
object
object
object
object
Exact inventory locations or geographic areas to target.
object
object
object
object
object
object
object
object
object
object
object
Optional demographic filters. Age codes are ranges: -18=under 18, 18=18–24, 25=25–34, 35=35–44, 45=45–54, 55=55–64, 65=65+. Adults 18+ requires all six adult ranges, not just 18. Gender ?? means unknown, not all genders; omit gender on creation or use [] on update for unrestricted gender.
object
object
The advertiser lets the system slightly adjust the audience to ensure a better reach. Campaigns saved before it existed have no value: not authorized
Budget in the campaign currency
ISO-2 Country
Currency ISO 4217. E.g. USD, EUR. A draft saved without it takes the currency of the account that saves it, else USD.
Exchange rate from local currency to USD
USD taken off the budget and not yet credited back to the organization
Unit price in local currency (CPM or CPC bid). Only for a campaign without ad groups
object
Tips the review raised when the campaign was last saved: the code the clients translate and the ad group it is about
object
Example
{ "origin": "ads", "rush": false, "status": "enabled", "timezone": "America/Argentina/Buenos_Aires", "type": "CPC", "verification": "approved", "audience": { "device": { "os": [ "android", "ios" ], "type": [ "mobile" ] }, "not": { "device": { "os": [ "android", "ios" ], "type": [ "mobile" ] }, "app": { "list": [ { "platform": "android" } ] }, "appFilters": { "platform": [ "android" ] }, "location": [ { "source": "google_places", "type": "place" } ], "user": { "gender": [ "female" ], "age": [ "-18" ] } }, "app": { "list": [ { "platform": "android" } ] }, "appFilters": { "platform": [ "android" ] }, "isDraft": true, "location": [ { "source": "google_places", "type": "place" } ], "user": { "gender": [ "female" ], "age": [ "-18" ] } }, "autopilot": true, "currency": "BRL", "format": "display", "isDraft": true, "method": "ai", "warnings": []}The API key is missing, invalid, disabled or expired.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key lacks the scope, or its owner lacks the dashboard permission.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The resource does not exist in the organization of the API key.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The request conflicts with the resource state.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}A precondition failed, e.g. the organization balance does not cover the launch.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key exceeded its rate limit; retry after the Retry-After seconds.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}Headers
Section titled “Headers”Seconds to wait before retrying.
Unexpected server error.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}© 2026 Wortise. All rights reserved.