How to get started with Events API

Last updated: December 2024

You can use Events API to set up web events with TikTok Pixel.


Before you begin

Before starting the Events API integration, consider if you have previously integrated server-to-server APIs with other publishers. If so, you may be able to utilize the same process to share event data with TikTok's Events API.


We recommend working with internal Marketing, Legal, and Technical teams to determine the scope of data to be shared via Events API.


How to setup Events API

After determining the scope of data to be shared:

  1. Define the Events, Parameters, and Match Keys that best align with your marketing objectives and review this with your legal and technical teams.

  2. Choose an integrating method:

    • Third-party Commerce Partner Integration like Shopify and WooCommerce.

    • Third-party Data Partner Integration if you are partnering with one of TikTok’s Data partners, such as Customer Data Platforms (CDPs), Tag Managers, and CRMs.

    • Direct API integration if you require more control of data management

  3. Choose between setting up Events API as either a standalone integration or a second channel together with your TikTok Pixel.

    • Note: We recommend setting up Events API as a second channel together with your TikTok Pixel.

  4. Review the appropriate documentation depending on the chosen integration method:

  5. Ensure your legal teams have reviewed and approved TikTok's Privacy and Data Usage policies and terms and how TikTok honors users' in-app and device-level privacy settings.

  6. We recommend you build a timeline that accounts for approvals, integration and setup methods, and in-house development or partner engagement resources.

  7. Once steps 1-6 have been aligned internally, you may set up Events API through a third-party partner or through your in-house technical teams.

  8. Once implemented, validate your Events API setup with our web diagnostics tools.

Note: To authenticate Events API 2.0 calls, you will need an access token. There are two ways to generate an access token for Events API. To learn more, visit the developers portal.

Next steps

Learn more about Events API.