Skip to main content
POST
Save a TikTok Spark 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
sparkCode
string
required

The Spark code the creator sent.

requestId
string

The open Spark code request this code answers.

creatorId
string
tiktokItemId
string

The numeric TikTok item ID of the video. Needed when no request or URL names the video.

sourcePostId
string
sourcePostUrl
string
sourcePlatform
string
postTitle
string
displayName
string
expiresAt
string

Response

Success. Returns the request, identity and authorization.

The response is of type object.