Spark Codes

Last updated: October 8, 2026

A Spark Code is a code a creator makes in TikTok that lets you run their video as a paid ad, called a Spark Ad. The Spark Codes page collects the codes creators send you, shows which videos still need one, and applies codes to your TikTok Ads account.

Why use it

To run a creator's video as a Spark Ad, you need the code for that video. Codes arrive in TikTok messages and forms, and they expire, so it's easy to lose track of which videos still need one. This page keeps track for you.

Where to find it

Go to Ads > Spark Codes. The page itself is titled Spark Ads, and its heading counts your Missing Spark Codes.

You can also ask Copilot, or an AI tool connected to Euka, to find the videos that still need a code, add codes you have, and apply codes to TikTok Ads.

Who can use it

Every plan.

What the list shows

Each row is a creator video that features your products, with its Revenue, Spark Code, Code Submitted Date, the creator's Form Link, Has Usage Rights, GMV Max, and TikTok Ads Status.

By default, the list hides videos that are already usable in GMV Max, TikTok's automated ad campaigns for Shops. A note says how many there are. To see every video, open Filter and set GMV Max Authorization to All.

How to collect Spark Codes

Codes reach us in three ways: in TikTok messages, through the Spark Code form, or from a CSV file you upload.

From TikTok messages

When a creator pastes a Spark Code into a TikTok Shop message to you, we pick it up the next time we sync your messages.

Through the Spark Code form

Each creator has a personal link to a Spark Collection Form in the Form Link column, which you can copy and send. The form shows the creator their videos with your products.

For each video, the creator pastes the code and picks when it expires. They can also tick a box that lets you use the video on your website and in other promotions. Codes from the form are matched to their video straight away.

To send the form with an agent:

  1. Filter the table to the creators you want, for example by sales (GMV) or post date.
  2. Click Collect Spark Codes via Agent. We make a list of the creators in the table who haven't sent a code.
  3. Click Continue agent setup.
  4. Finish the Message + Spark Code Form agent. It messages each creator their form link.

Creators can answer by form or by DM, and we collect codes from both. You can also start this agent with Ask for Spark Codes in Affiliate CRM > Segments, or pick Message + Spark Code Form when you create any agent. See Outreach agents.

From a CSV file

Click Upload Existing Spark Codes. The upload window links to a sample file. Your file needs:

  • one column, with the header spark_codes in the first row
  • one code per row
  • codes that start with #, end with =, and contain both letters and numbers
  • a size of 10 MB or less

Codes that don't look like Spark Codes are skipped and listed. Repeats within the file, and codes another Shop already holds, are skipped too. The rest show as unprocessed at the top of the page until we match each one to its video.

How to use codes in TikTok Ads and GMV Max

Apply to TikTok Ads sends codes to a TikTok Ads advertiser account for Spark Ads. It needs TikTok Ads connected, in Settings > Integrations > TikTok.

  1. Filter the table to the codes you want to apply.
  2. Click Apply to TikTok Ads.
  3. Choose the Advertiser Account.
  4. Click Confirm Import. We send every code in your filter results that hasn't expired.

The results count the codes as Processing, Success, Already Uploaded, or Failed, and you can close the window while they process. The TikTok Ads Status column then shows Applied, Processing, or Failed for each advertiser account.

The GMV Max column

The GMV Max column shows what TikTok reports about the video in your active GMV Max campaigns:

Label What it means
Affiliate authorized Runs through TikTok Shop's affiliate authorization, which needs no Spark Code.
Video code Runs on a Spark Code already bound to your TikTok ad account.
Own account Posted by an account linked to your Shop or ad account.
Needs authorization Not yet authorized for ads in your active GMV Max campaigns.
No active campaign No delivery status in any active GMV Max campaign.
Advertised Already has GMV Max ad spend.

Set up GMV Max automation rules, at the top of the page, opens GMV Max. See GMV Max.

How to export codes

Click Export to download the filtered rows as a CSV file, newest codes first. The file has the video, the creator and their contact details, the product, the code and its expiry, usage rights (permission to use the creator's video in your own ads), GMV Max authorization, and the form link.

Rules and limits

  • Export and Apply to TikTok Ads both cover every row your filters match, however many that is. A large one takes a while to gather, so leave the page open until the file downloads or the results window appears.
  • Apply to TikTok Ads skips expired codes.
  • We delete a code within the hour after it expires, and its video counts as missing a code again.
  • Download Video, under Actions, works only when Has Usage Rights is Yes, meaning the creator gave permission on the form. Those videos also appear in your Licensed Content library.

What we don't control

Creators make Spark Codes in TikTok, under TikTok's rules, including how long a code lasts. TikTok also decides whether an advertiser account accepts a code, and the GMV Max column shows only what TikTok reports.

When something goes wrong

  • "Connect TikTok Ads Account" when you click Apply to TikTok Ads: click Connect Account and authorize your TikTok Ads account.
  • "No advertiser accounts authorized for this connection.": in Settings, disconnect TikTok Ads. Then reconnect with a TikTok user who can authorize the advertiser account, and select it during authorization.
  • "No valid spark codes": your filter results hold no codes that haven't expired. Change the filters, or collect new codes.
  • "Some codes were invalid" after an upload: those codes didn't match the format. Fix them and upload them again.
  • "Import failed" when you confirm: the codes didn't start processing. Click Apply to TikTok Ads again. Codes that already went through are skipped.
  • Failed in TikTok Ads Status: hover over it to see TikTok's reason.

FAQs

Is Spark Codes under Affiliate CRM?

No, it's under Ads: Ads > Spark Codes. The page itself is titled Spark Ads.

Why isn't a video in the list?

Unless you set GMV Max Authorization to All in Filter, the list leaves out videos TikTok already lets you use in GMV Max.

Why did a Spark Code disappear?

It expired. We remove expired codes every hour, so ask the creator for a new one.

Do I need a Spark Code for GMV Max?

Not for a video the GMV Max column marks Affiliate authorized or Own account: TikTok reports that GMV Max can already use it.

Does a Spark Code give me usage rights?

No. It lets you run the video as a Spark Ad on TikTok. To use the video elsewhere, the creator can give permission on the form, or you can request usage rights.