TikTok keeps leads for 90 days. Ciarem receives each lead as it arrives and stores it, so your contacts outlive that window.
Connect an ad account
Leads belong to a TikTok ad account, so you connect the ad accounts that run your lead ads.1
Open TikTok Lead Generation
Go to Settings, then Integrations, and click Connect on the TikTok Lead Generation card.
2
Sign in to TikTok for Business
Sign in with a TikTok for Business account that manages the ad accounts, and authorize Ciarem.
3
Pick your ad accounts
Tick every ad account that runs your lead ads and click Connect. You can add more later with Connect ad account.
4
Check your forms
The ad account’s Instant Forms appear under Lead forms. A form you publish later in TikTok Ads Manager shows up there too. Click Refresh if you don’t see it yet.
Lead forms
The Lead forms table shows, for each form, its submissions, the contacts created, and how many need attention. Submissions that didn’t become a contact usually point to a mapping problem. A form shows Ready when every question has a destination, or how many questions are still unmapped. Every ad account also has a Direct messages row. These are the leads TikTok extracts from your message ads: there is no form, so only the name, email and phone number can arrive. You can pause them and give them an auto-reply like any form.Map the questions
Open a form to choose where each answer lands, under Question mapping. Standard questions such as name, email, and phone map on their own. Custom questions need a destination: a contact field or a custom property. Click Save changes. A mapping change applies to new leads only; leads already received keep the mapping they arrived with. When a question lands in a property with options, each answer goes to the option with the same label. TikTok doesn’t share a question’s answer choices with Ciarem, so a property you create from a question is a text property. To pause a form, turn off Create contacts from this form. Its submissions are still saved, but no contacts are created while it’s off.How leads match your contacts
A lead needs an email or a phone number to become a contact. Ciarem first looks for a contact with the same email, then one with the same phone:- No match: Ciarem creates a new contact, with the TikTok ad as its origin.
- Match: the lead’s name, email, and phone only fill fields that are empty on the contact, so nothing your team or the AI agent already set is replaced. Custom properties you mapped are updated with the newest lead’s answers. An empty answer never clears a property.
When a new lead arrives
- Auto-reply template: pick an approved WhatsApp template and it is sent to every new lead on this form as soon as they arrive. Each send is charged to your WhatsApp wallet at Meta’s rate, like any template.
- Create a follow-up task when the auto-reply can’t be sent: when this is on and no auto-reply goes out, either because no template is chosen or because it couldn’t be sent, Ciarem creates a task due 24 hours after the lead arrived, for the contact’s owner. A new lead usually has no owner yet, so admins find the task under No owner.
Submission history
Each form keeps a Submission history with every lead’s outcome: the contact it created or updated, whether the auto-reply was sent, and why a lead didn’t become a contact.Disconnect an ad account
Disconnect stops new leads from that ad account from creating contacts. Your form mappings are kept and apply again if you reconnect.Troubleshooting
My ad account isn’t in the list
TikTok only lists the ad accounts the account you signed in with can manage. Sign in with a TikTok for Business account that has access to the ad account, then click Connect ad account again.”This TikTok ad account is already connected to another workspace”
An ad account can only send its leads to one Ciarem workspace. Disconnect it from the other workspace first, then connect it here.”We can no longer read this ad account’s lead forms”
Ciarem lost access to the ad account. This usually happens when the access was revoked in TikTok for Business or the person who connected it lost their role on the ad account. Click Reconnect and sign in again.Leads aren’t arriving
- Check the form’s Submission history. If the lead is there, its outcome says why it didn’t become a contact. The usual causes are a paused form or a lead with no email and no phone number.
- If the lead isn’t there at all, check that the ad account shows as connected with no Reconnect warning.
- Leads submitted before you connected the ad account aren’t imported.