Skip to main content
POST
Save a Snapchat ad code a creator sent

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
required
brandProfileId
string
required
code
string
required

The ad code the creator sent.

Minimum string length: 1
companyId
string

Optional assertion of the token company; mismatches are refused.

sourcePostId
string

The SideShift source post the code is for, when known.

creatorId
string

The creator who sent the code, when known.

Response

The saved code's id and fingerprint, with its revision and state.