---
title: "TiktokOfflineEvents: Create job"
method: POST
path: "/job/tiktok-offline-events"
tags: ["Jobs"]
---

# TiktokOfflineEvents: Create job

`POST /job/tiktok-offline-events`

## Request

- Base URL: `https://api.lytics.io/v2`
- URL: `https://api.lytics.io/v2/job/tiktok-offline-events`
- Auth: API key in header `Authorization`

Create a TiktokOfflineEvents job

## Query parameters

- `account_id` string

## Request body `*/*`

- object
  - `auth_ids` string[]: Authorization IDs associated with the Job
  - `config` object, required: Job configuration, unique per-workflow
    - `audience_events` 'enters_only' | 'exits_only': Select which type of audience trigger events to send to TikTok. By default both enters and exits with be sent.
    - `event_id` string: Select user field that contains a unique event ID for deduplication
    - `event_name` string: Select the action source for this conversion. If Action Source is not mapped or the user field is empty, this value will be used
    - `event_source` string: Select the Event Name associated with this conversion. If Event Name is not mapped or the user field is empty, this value will be used
    - `event_time` string: Select user field that contains the event time
    - `field_changes` string[]: Select up to 75 user fields to trigger user change events. For any user in the exported audience, if any of the selected field values change, then the user field change event will be sent to the TikTok API.
    - `identifier_mapping` object[], required: Map all the identifier fields from Lytics to TikTok by selecting the Lytics field on the left, and its TikTok destination on the right
    - `offline_event_set_id` string, required: Enter the Offline Event Set ID associated with these conversions
    - `property_mapping` object[], required: Map all the property fields from Lytics to TikTok by selecting the Lytics field on the left, and its TikTok destination on the right
    - `segment_ids` string[], required: Select the audiences to export
  - `description` string: A user-defined description
  - `drop_events_during_quiet_window` boolean
  - `expires_at` string, date-time
  - `monitoring` object: Inline monitoring config. On write: omit to keep, null to clear, or a config to set.
  - `name` string, required: A user-defined name
  - `quiet_period` integer
  - `quiet_time_of_day` string
  - `quiet_timezone` string

## Response `201`

TiktokOfflineEvents Job

- object
  - `_meta` object: Response Metadata
  - `data` object: Response Payload
    - `account_id` string: Lytics Account ID
    - `anomaly_rule` ModelsAnomalyRuleResp
      - `aid` integer
      - `checks` ModelsRuleCheckConfigReq[]
        - `allowable_violations` integer
        - `interval` string
        - `lookback_count` integer
        - `max_threshold` integer
        - `metric_type` string
        - `min_threshold` integer
        - `type` string
        - `variance_pct` number
      - `created` string
      - `id` string
      - `subject_id` string
      - `subject_type` string
      - `updated` string
    - `api_token_auth_id` string: this is set when work is create using access token
    - `auth_ids` string[]: Authorization IDs associated with the Job
    - `config` object, required: Job configuration, unique per-workflow
      - `audience_events` 'enters_only' | 'exits_only': Select which type of audience trigger events to send to TikTok. By default both enters and exits with be sent.
      - `event_id` string: Select user field that contains a unique event ID for deduplication
      - `event_name` string: Select the action source for this conversion. If Action Source is not mapped or the user field is empty, this value will be used
      - `event_source` string: Select the Event Name associated with this conversion. If Event Name is not mapped or the user field is empty, this value will be used
      - `event_time` string: Select user field that contains the event time
      - `field_changes` string[]: Select up to 75 user fields to trigger user change events. For any user in the exported audience, if any of the selected field values change, then the user field change event will be sent to the TikTok API.
      - `identifier_mapping` object[], required: Map all the identifier fields from Lytics to TikTok by selecting the Lytics field on the left, and its TikTok destination on the right
      - `offline_event_set_id` string, required: Enter the Offline Event Set ID associated with these conversions
      - `property_mapping` object[], required: Map all the property fields from Lytics to TikTok by selecting the Lytics field on the left, and its TikTok destination on the right
      - `segment_ids` string[], required: Select the audiences to export
    - `created` string
    - `deleted` boolean: The Job has been deleted
    - `description` string: A user-defined description
    - `drop_events_during_quiet_window` boolean
    - `expires_at` string, date-time
    - `id` string: A Lytics-assigned, immutable unique ID for the Job
    - `meta` object: Extra meta data about the job
    - `monitoring` object: Inline monitoring config. On write: omit to keep, null to clear, or a config to set.
    - `name` string, required: A user-defined name
    - `quiet_period` integer
    - `quiet_time_of_day` string
    - `quiet_timezone` string
    - `sleep_until` string
    - `status` 'runnable' | 'sleeping' | 'paused' | 'completed' | 'fault' | 'failed' | 'killed' | 'deleted' | 'unknown': The status of the job
    - `updated` string
    - `user_id` string: The user ID that created or updated the job
    - `workflow` string: The workflow slug
    - `workflow_id` string: The workflow ID
  - `request_id` string
  - `status` integer: HTTP Status Code

## Other responses

- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `d8e975057aec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lytics/apis/lytics-api/changes/job/tiktok-offline-events/post.md)

---

[API](https://skmtc.dev/lytics/apis/lytics-api.md) - [All operations](https://skmtc.dev/lytics/apis/lytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lytics/apis/lytics-api/revisions/d8e975057aec?raw)