TikTok Ads Integration

Connect your TikTok Ads account so every lead form submission from your ads creates or updates a contact in Vixiees, with its campaign, ad group and ad.

Integraciones
5 min read
Nov 20, 2026

Connect TikTok Ads with Vixiees so that everyone who fills in one of your TikTok ad forms instantly becomes a contact, assigned to the Sales Brain (Playbook) and status you choose.


1. Connect your TikTok Ads account

  • Go to Settings › Integrations. In the Lead capture section you'll find the TikTok Ads card.
  • Open the General tab and click Connect with TikTok. TikTok asks you to log in and authorize Vixiees to access your ad accounts.
  • Back in Vixiees you'll see TikTok Ads connected, and the card shows Connected.
  • Vixiees imports the lead forms of every ad account you authorized.
  • Only account admins can connect, configure and disconnect the integration.
TikTok Ads card in Settings › Integrations
TikTok Ads card in Settings › Integrations
General tab of the TikTok Ads integration with the Connect with TikTok button
General tab of the TikTok Ads integration with the Connect with TikTok button

2. Configure each form

The Forms tab lists the forms of each ad account. For each one you can set:

  • Sales Brain (Playbook) and status the contact goes to when it's created. If you don't pick one, the contact goes to the account's default Sales Brain (Playbook) and status.
  • What happens when an existing contact submits the form again: keep it where it is (its data is still updated), move it unless it's won or lost, or always move it to the configured status.
  • Field mapping: map each form question to a contact field, a custom attribute or skills.

A form is only Configured once email or phone is mapped. Submissions from a form with neither don't create contacts and show up as an error in the webhook log.

Answers to questions you haven't mapped aren't lost: they're kept in the submitted form shown in the contact's activity.

New forms and forms that no longer exist

  • If you create a form in TikTok after connecting, Vixiees picks it up on its own once a day. If you don't want to wait, click Refresh forms.
  • Forms TikTok no longer offers show as Unavailable: their submissions aren't imported and don't appear in the webhook log. Their configuration is kept.

3. How contacts arrive

  • Every form submission instantly creates a contact with the source TikTok Ads.
  • If a contact with the same email or phone already exists, it's updated instead of creating a new one. Mapped values that aren't empty replace the previous ones.
  • Each submission is recorded in the contact's activity with its answers and, when it came from an ad, the campaign, ad group and ad.
  • The campaign, ad group and ad that brought the contact are saved the first time it arrives from TikTok, and aren't overwritten if the contact submits another form.

4. Webhook log

The Webhook log tab lists every submission received for your forms, with its date, the form and the result:

  • Contact created or Contact updated: links to the contact. If any field couldn't be saved, you'll see it flagged; the contact is saved anyway and you can review those fields in the form.
  • Error: explains what went wrong and what to do. For example, The form is not configured (it needs at least an email or phone field) or The form is not imported yet (refresh the forms to import it).
  • Received: the submission arrived and is still being processed.
  • Skipped: the submission wasn't processed.

A submission that didn't come from an ad is marked as an Organic lead.


5. Connection status, reconnecting and disconnecting

  • The General tab shows whether the connection works. If TikTok stops giving Vixiees access (for example, because someone removed the authorization in TikTok), the integration shows Connection lost and asks you to reconnect. Reconnecting is also useful if you've changed accounts or need to refresh permissions.
  • Reconnecting keeps your forms and their configuration.
  • If you disconnect TikTok Ads, new submissions stop arriving. Your form settings are kept for when you reconnect, and your existing contacts aren't affected.

6. TikTok Ads across Vixiees

TikTok Ads works as a contact source in the same places as Meta Ads:

  • Analytics: it appears as a source in the breakdown of contacts by source.
  • Contacts: you can filter the list by the TikTok Ads source, and the contact's page shows the campaign, ad group and ad.
  • Workflows: you can add conditions on the contact's source and on its campaign, ad group or ad.
  • API and webhooks: the contact's TikTok data and each submitted form are also available in the public API and in submitted-form webhooks.
  • AI assistant: it can check the status of your TikTok Ads connection and your forms.

Conclusion

With the TikTok Ads integration, contacts from your TikTok campaigns land in Vixiees instantly, in the right Sales Brain (Playbook) and with the ad that brought them, so your team can follow up without copying data by hand.


Relevant scenarios

If you run high-volume lead generation campaigns on TikTok, assigning a Sales Brain (Playbook) and status to each form puts every contact straight into your salespeople's work queue, and the webhook log lets you spot a misconfigured form right away, before contacts are lost.

Was this article helpful?

Related Articles

TikTok Ads Integration | Vixiees Help