Configuring TikTok Leads
Follow the step to complete the configuration.Create contact attribute
To track what form the customer has arrived from, you’ll need to first go to Config Hub and create a custom attribute called 
Do it like this:
customSource of type “string”.Learn about Config Hub
Initial setup
Now log into Onsite Manager:Or go to Config Hub again where you can configure Lead Ads.
Take me to Onsite Manager
Contact Voyado Support
Accelerator Setup
In Onsite Manager go to: Accelerator Configuration → Accelerators for lead adsIf this section is missing, contact Voyado’s support;Use your existing site in OSM. Currently, you can only connect to one site in OSM.
Contact Voyado Support
Connect to TikTok
In Onsite Manager press Actions → Edit.In the TikTok section, connect to your TikTok Page.Select Connect then add the account you want to connect to:
Form mapping
Once connected, Engage will pull in your TikTok Lead Forms.If no forms are visible, ensure one has been created for your campaign.Choose the form you want and then map its fields to Engage.The Get forms button will fetch all the forms on your page that you can connect to Voyado Engage.Once you’ve done that, you will get a list of forms under TikTok forms.Press on the form that you want to connect to Engage and then press the button Get fields. This will retrive all the fields on that specific form.Do the mapping of fields as shown in the image and then press Save.
Testing
After setting up your TikTok Lead Ads integration in Engage, you’ll want to check that your setup works as expected. You can use TikTok’s built-in Lead Ads Testing Tool to create test submissions that simulate a real lead. This is especially useful before running a live campaign. Before you begin, make sure that:- Your TikTok Page and Lead Form are already created
- The TikTok Lead Ads integration is active in Engage
- You’ve selected the correct Page and Form in the integration setup
- Your TikTok user has the right permissions
1. Open the testing tool
Visit TikTok’s Lead Ads Testing Tool, here:Show me TikTok's testing tool
2. Select your TikTok Lead Form
From the dropdowns:- Choose the TikTok account running your lead ad
- Select the form you want to test
3. Create a test lead
Select Create Lead to simulate a new lead submission.4. Verify the lead in Engage
Once created, go back to Voyado Engage to verify the lead exists. You can do this in two ways:- Searching directly for the contact in Engage
- Or looking for them via segmentations using either:
- customSource: [[name of form]]
- source: TikTok
5. Troubleshooting
If the lead doesn’t appear:- Ensure your TikTok user has Leads Access to the account
- Recheck that the correct TikTok account and Form are selected in Engage
- Check if the lead was already created; duplicate test submissions might be ignored if your form doesn’t allow them