API referenceLaunches

Apply campaign snapshot template

Copies the campaign settings stored in the snapshot template onto the campaign already in the launch. It does not create ad sets or ads, and fails on a launch with no campaign.

POST
/v1/brands/{brandId}/launches/{launchId}/snapshot-templates/{templateId}/apply
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.

brandId*integer

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

launchId*string

The campaign launch (batch) id.

templateId*string

ID of the template to apply

Match^[1-9]\d*$
Length1 <= length
Idempotency-Key?string

Retrying with the same key within 24 hours returns the first response without acting again.

Lengthlength <= 255

Response Body

Apply campaign snapshot template

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

Required scope: write. CLI: koast apply-snapshot-template, see Launches commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.