Skip to main content
POST
Request a Meta partnership ad code from a creator

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
creatorId
string
required

The creator to ask.

sourcePostId
string
required

The ID of the creator's Instagram post, as SideShift tracks it. Use the same value as postId to read the code.

sourcePostUrl
string
sourcePlatform
string
postTitle
string

Response

Success. Returns the request, reused and autoFulfilled.

The response is of type object.