API referenceLaunches

Get ad details

Returns the full details of one ad in the launch: creative, copy, links, call to action and tracking.

GET
/v1/brands/{brandId}/launches/{launchId}/ads/{adId}

Authorization

bearerAuth
headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

Path Parameters

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

launchId*string

The campaign launch (batch) id.

adId*string

ID of the ad to get details for

Length1 <= length

Response Body

Get ad details

application/json
  1. response
[key: string]?unknown
curl -X GET "https://example.com/v1/brands/0/launches/string/ads/string" \  -H "Authorization: Bearer koast_sk_..."
{  "property1": null,  "property2": null}

Required scope: read. CLI: koast get-ad-details, see Launches commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.

Add ads

Creates 1-100 ads, each under its own adsetNodeId, optionally attaching a creativeId and a copyGenerationId in the same request. Partial success is possible: unknown ad sets are returned in notFound and per-ad errors in failed, while the rest are created.

Add campaign

Adds the campaign to the launch. A launch holds at most one campaign, so this fails if one already exists. objective is one of website-conversions, lead-form or traffic; platform-native objective names are rejected.