Send TikTok lead ads leads to Juiced

Before you start

• In TikTok: a TikTok Ads Manager account with admin access and at least one Instant Form (TikTok: integrate with Zapier). Add a zip or postal code question to the form; TikTok lists postal/zip code among its contact information questions, which it auto-fills when possible (TikTok: Instant Form question types).
• A connector: Zapier on a paid plan (Webhooks by Zapier is not on Free), or Make with a TikTok for Business account that has API access.
• In Juiced: a source, its bearer token, and the field names from View API Spec.

TikTok also lists direct CRM integrations (such as HubSpot and Salesforce) and a TikTok Custom API with Webhooks for building your own connection (TikTok: available CRM integrations). Juiced is not on the direct list, and the custom API is developer work, so most sellers use Zapier or Make.

Step by step

1. Create a source and copy a bearer token

   In Juiced, go to Ingest > Sources > New source, turn on Test mode, click Create source, then create and copy a bearer token on the Authentication tab. Open View API Spec for the field names. Details: setting up a source.

2. Connect Zapier from TikTok Ads Manager

   In Ads Manager, select the Tools tab, select Leads Center and click Connect CRM. Find Zapier, select TikTok direct integration, sign in to Zapier, authorize access to the ad account, agree to the Platform Service Agreement and click Confirm. The Zapier editor opens inside Ads Manager. You can also start in Zapier and connect the account there.

3. Choose the trigger and Instant Form

   Select TikTok Lead Generation as the trigger app with the New Lead event (its only trigger on Zapier), choose your Ads Manager account from the dropdown, select the Instant Form and test the trigger.

4. Add the POST to Juiced

   Add the request that sends JSON to https://usejuiced.com/api/v1/leads with your bearer token, mapping each form field to a Juiced key (table below). Follow the Zapier POST step.

5. Send a test lead

   TikTok's Google Sheets integration guide notes you can send a real, customized test lead when previewing a lead generation form under Assets; its Zapier guide does not mention this, so check the option in your account. Use zip 00001. In Juiced, open Entries > Incoming logs, filter Test mode to Test only, and open the log to check every field.

6. Publish and go live

   Test the Zap, turn it on, and turn off Test mode on the Juiced source. Build a Zap for each Instant Form you run.

Field mapping

Keys must match the field Title in Juiced exactly and be sent as top-level keys. Ad and form IDs can be kept by creating fields such as tiktok_form_id.

TrustedForm and Jornaya

Instant Forms run inside TikTok, not on your website, so a TrustedForm or Jornaya script never loads on them and there is no certificate to map. Buyers often ask for one, so tell them in advance that these leads come from TikTok Instant Forms. For sources that do capture certificates, see passing TrustedForm and Jornaya certificates.

Troubleshooting

• The ad account is not in the dropdown. You need admin access to the Ads Manager account. Ask an admin to grant it, then reconnect.
• Make cannot connect. Check the Client ID, Client Secret and callback URL in your TikTok developer app, and that your TikTok for Business account has API access.
• Leads from a second form never arrive. The trigger watches the Instant Form you selected. Build a Zap or scenario for each form.
• 422 with a zip error. error.code is validation_failed and errors names zip. The form has no postal/zip code question, or the mapping points at the wrong field.
• 401 Unauthorized. Check the bearer header has one space after Bearer and no line break, and that the token was not replaced more than 24 hours ago.

More fixes: webhook troubleshooting.

Frequently asked