# TikTok Events API

> Report web, offline, app, and CRM conversions through TikTok Events API 2.0 with stable event IDs.

App · 2 actions. Web page: https://docs.lodol.com/docs/integrations/tiktok-events

## Actions

### Send event

Send event.

**Inputs**

- Event source (`event_source`, text, required): Event source. One of: `web`, `offline`, `crm`.
- Event source id (`event_source_id`, text, required): Event source id.
- Event (`event`, text, required): Event. One of: `AddPaymentInfo`, `AddToCart`, `AddToWishlist`, `ApplicationApproval`, `CompleteRegistration`, `Contact`, `CustomizeProduct`, `Download`, `FindLocation`, `InitiateCheckout`, and 9 more.
- Custom event name (`custom_event_name`, text): Custom event name.
- Event time (`event_time`, date and time, required): Event time.
- Event id (`event_id`, text, required): A stable unique ID for this event. Reuse it when resending the same event.
- Page url (`page_url`, text): Full page URL, required for web events.
- Referrer (`referrer`, text): Referrer.
- Lead id (`lead_id`, text): TikTok lead ID, required for CRM events.
- Email (`email`, text): Customer email. Lodol trims, lowercases and hashes it with SHA-256.
- Phone (`phone`, text): Customer phone in E.164 format, including + and country code. Lodol hashes it with SHA-256.
- External id (`external_id`, text): Customer identifier. Lodol hashes it with SHA-256.
- Ttclid (`ttclid`, text): Ttclid.
- Ttp (`ttp`, text): Ttp.
- Ip (`ip`, text): Ip.
- User agent (`user_agent`, text): User agent.
- Properties (`properties`, object): Properties.
- Limited data use (`limited_data_use`, true/false): Limited data use.

**Outputs**

- `data` (object): Tik Tok Events API response data.

**Example output**

```json
{
  "data": {}
}
```

### Send events

Send up to 1,000 already prepared events. Use Unix seconds for event_time and SHA-256 hashes for email, phone, and external_id. App events require TikTok approval.

**Inputs**

- Event source (`event_source`, text, required): Event source. One of: `web`, `app`, `offline`, `crm`.
- Event source id (`event_source_id`, text, required): Event source id.
- Events (`events`, list, required): Events.

**Outputs**

- `data` (object): Tik Tok Events API response data.

**Example output**

```json
{
  "data": {}
}
```
