Skip to main content
POST
Extend the Spark Ads code of a TikTok post

Authorizations

x-api-key
string
header
required

Body

application/json

Body

teamId
string
required
postId
string

The ID of a post in bundle.social published to TikTok. Pass this or platformPostId.

platformPostId
string

The TikTok post ID (item_id) of a public post on the team's TikTok account, for posts published outside bundle.social. Pass this or postId.

Pattern: ^\d+$
authorizationDays
enum<number>

Days added to the current validity period (7, 30, 60, 180 or 365, default 30). If the code was deleted, the validity period of the new code.

Available options:
7,
30,
60,
180,
365

Response

200

platformPostId
string
required

The TikTok post ID (item_id).

authCode
string
required

Spark Ads authorization code. The advertiser adds it to their TikTok ad account to run this post as a Spark Ad.

startsAt
string | null
required

When the code becomes valid, ISO 8601 in UTC.

expiresAt
string | null
required

When the code expires, ISO 8601 in UTC.

authorizationDays
number | null
required

Validity period of the code in days.

status
enum<string> | null
required

NOT_USED, IN_USE or EXPIRED. Always set by the status endpoint; usually null on enable and extend.

Available options:
NOT_USED,
IN_USE,
EXPIRED