Skip to main content
POST
Accept a Snapchat native ad launch

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Headers

Idempotency-Key
string

Client-chosen key; replaying the same key + body returns the original response, a different body returns 409.

Body

application/json
connectionId
string
required
advertiserAccountId
string<uuid>
required
brandProfileId
string<uuid>
required
currency
string
required
Pattern: ^[A-Z]{3}$
sources
object[]
required
Required array length: 1 - 50 elements
desiredStatus
enum<string>
required
Available options:
PAUSED,
ACTIVE
campaign
object
required
adGroup
object
required
objective
enum<string>
required
Available options:
traffic,
conversions,
app-installs,
maximize-reach
audience
object
required
budget
object
required
schedule
object
required
attachment
object
required
companyId
string

Optional assertion of the token company; mismatches are refused.

pixelId
string<uuid>
conversionWindow
string
optimizationGoal
enum<string>

Conversions only. The pixel event the ad squad optimizes for. Omitted: PIXEL_PURCHASE.

Available options:
PIXEL_PURCHASE,
PIXEL_SIGNUP,
PIXEL_ADD_TO_CART,
PIXEL_PAGE_VIEW
confirmedParentActivation
object

Response

Pending durable operation receipt with server operationId and status.