> ## Documentation Index
> Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Tik Tok Leads - BETA
This feature is currently in BETA and Voyado is actively seeking user feedback to improve its performance and function. As a beta feature, it may undergo frequent updates and enhancements. Check for updates regularly to take advantage of the latest improvements. While beta features have been rigorously tested, they could contain issues, bugs, or glitches. Be prepared for occasional disruptions, and report any issues you find.
To gain access to TikTok leads, Engage users should contact their Voyado account manager.
## Configuring TikTok Leads
Follow the step to complete the configuration.
To track what form the customer has arrived from, you'll need to first go to **Config Hub** and create a custom attribute called `customSource` of type "string".
Do it like this:
The same custom contact attribute is used for TikTok and Meta, so if this has already been set up for Meta, skip this step.
Now log into Onsite Manager:
Or go to **Config Hub** again where you can configure Lead Ads.
If you don't see Lead Ads in Config Hub, contact Voyado's support:
In Onsite Manager go to: **Accelerator Configuration → Accelerators for lead ads**
If this section is missing, contact Voyado's support;
Use your existing site in OSM. Currently, you can only connect to **one** site in OSM.
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:
Press **Confirm** and you should be authenticated to TikTok.
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
Then follow this procedure:
### 1. Open the testing tool
Visit TikTok's Lead Ads Testing Tool, here:
### 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.
This lead will not appear in your Ads Manager or Page Inbox, only through the API integration.
### 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
To remove test data, delete the test contact directly in Engage after verification.