TikTok Custom Audiences

Built by John Rippy | johnrippy.link

🏆 2025 Zapier Automation Hero of the Year — Project Phoenix: A 95-step AI sales pipeline cutting development time by 50%. Read more →

TikTok Ads API - Create Audiences & Lookalikes with Auto-Hashing

Create and manage TikTok Custom Audiences via the TikTok Marketing API. Upload customer files with automatic SHA256 hashing, create lookalike audiences, and manage segments for TikTok advertising campaigns.

Features

Audience Management

• create_audience - Create a new custom audience
• get_audience - Get details of a specific audience
• list_audiences - List all custom audiences
• update_audience - Update audience name
• delete_audience - Delete a custom audience

User Management

• upload_users - Upload users to audience (auto-hashes PII)
• get_audience_size - Get audience size and status

Advanced Features

• create_lookalike - Create lookalike audience from source
• share_audience - Share audience with another advertiser

Authentication

Requires TikTok Marketing API access token with:

• Audience Management permission
• Access to the advertiser account

Getting an Access Token

1. Create a TikTok for Business account
2. Register as a developer at ads.tiktok.com/marketing_api
3. Create an app and get API credentials
4. Complete OAuth flow for access token

User Data Format

Email Upload

[
  { "email": "john@example.com" },
  { "email": "jane@example.com" }
]

Phone Upload

[
  { "phone": "+15551234567" },
  { "phone": "+15559876543" }
]

Device ID Upload

[
  { "idfa": "AEBE52E7-03EE-455A-B3C4-E57283966239" },
  { "gaid": "38400000-8cf0-11bd-b23e-10b96e40000d" }
]

Automatic Hashing

The actor automatically:

1. Normalizes data (lowercase, trim whitespace)
2. Removes special characters from phone numbers
3. SHA256 hashes email and phone data

If your data is already hashed, set isAlreadyHashed: true and use EMAIL_SHA256 or PHONE_SHA256 as fileType.

Audience Types

Type	Description
CUSTOMER_FILE	Upload email, phone, or device IDs
ENGAGEMENT	Users who engaged with TikTok content
APP_ACTIVITY	Users from app install/events
LEAD_GENERATION	Leads from TikTok lead forms
BUSINESS_ACCOUNT	Followers/viewers of TikTok account
SHOP_ACTIVITY	TikTok Shop customers
OFFLINE	Offline event data

Lookalike Options

Type	Description
NARROW	Smallest, most similar audience (1-2%)
BALANCED	Medium similarity and reach (2-5%)
BROAD	Largest reach, less similar (5-10%)

Use Cases

Retarget Customers

1. Export customer emails from CRM
2. Use upload_users with fileType: EMAIL
3. Create TikTok ad campaigns targeting the audience

Expand Reach

1. Create audience of best customers
2. Use create_lookalike with BALANCED type
3. Reach similar users on TikTok

Cross-Account Sharing

1. Create audience in main account
2. Use share_audience with agency account ID
3. Agency can target same audience

Output Format

Audience Object

{
  "audience_id": "7123456789012345678",
  "name": "High Value Customers",
  "audience_type": "CUSTOMER_FILE",
  "cover_num": 15420,
  "is_valid": true,
  "is_expiring": false,
  "create_time": "2024-01-20 14:30:00",
  "modify_time": "2024-01-21 10:15:00"
}

Upload Response

{
  "audience_id": "7123456789012345678",
  "upload_num": 1000,
  "match_num": 650,
  "match_rate": 65.0,
  "status": "PROCESSING"
}

Rate Limits

• 10 requests per second per app
• 1000 audiences per advertiser
• 10 million users per audience
• Recommended batch size: 500,000 users per upload

Minimum Audience Sizes

• Custom audiences: 1,000 matched users
• Lookalike audiences: Source must have 1,000+ users

Pricing

$0.01 per query (all tasks)

Compliance Notes

• Obtain proper consent before uploading user data
• Data is hashed before transmission to TikTok
• TikTok matches hashes against their user base
• Users must be 18+ for advertising targeting
• Follow TikTok's advertising policies