Tiktok

10 tools available

TikTok short-form video platform + creation tools + social sharing

Connect Tiktok to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Tiktok's 10 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Common workflows with Tiktok

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

  1. Read records from one app
  2. Transform with a persona
  3. Write the result back via this integration

Tiktok actions 10

Every Tiktok action below is a callable tool any Definable persona can invoke.

Fetch publish status

Check the processing status of a TikTok video or photo post using its publish_id. Use this action to poll the status of content after initiating an upload or post. The API returns detailed information about processing stages (upload, download, moderation) and any errors that occurred. Non-terminal statuses mean processing is still pending — never re-initiate TIKTOK_PUBLISH_VIDEO for the same publish_id. Use exponential backoff when polling (e.g., 5s→10s→20s) to avoid the 30 requests/minute per access token rate limit.

Get action categories

Tool to retrieve available action categories from TikTok Marketing API. Use when you need to get the list of conversion event categories for creating or managing TikTok ad campaigns with conversion tracking.

Get terms

Tool to retrieve terms from TikTok Business API. Use when you need to fetch advertiser or agency terms for a specific advertiser ID.

Get user stats

Fetches TikTok user information and statistics for the authenticated user. Retrieves user stats (follower_count, following_count, likes_count, video_count) and can optionally fetch profile fields (display_name, username, bio_description, etc.) and basic info (open_id, union_id, avatar URLs). Returns only the fields requested in the fields parameter. Only works for the authenticated account; cannot fetch arbitrary public profiles. Stats may be delayed and not reflect the most recent activity.

List GMV Max occupied custom shop ads

Tool to get GMV Max occupied custom shop ads list for a TikTok advertiser. Use this action when you need to retrieve information about which custom shop ads are currently occupied for GMV Max campaigns. This is part of the TikTok Business API and requires appropriate advertiser access.

List videos

Lists videos for the authenticated user (or specified creator). Does not provide a global TikTok-wide feed.

Post photo

Create a photo post (1-35 images) on TikTok via Content Posting API. Supports two modes: - MEDIA_UPLOAD: Uploads photos to user's inbox for review/editing before posting - DIRECT_POST: Immediately posts photos to user's TikTok account IMPORTANT: Photo URLs must be from your TikTok-verified domain. Unverified domains will return 403 Forbidden. Unaudited apps can only post with privacy='SELF_ONLY'. Rate limit: 6 requests per minute per user access token. Reference: https://developers.tiktok.com/doc/content-posting-api-reference-photo-post

Publish video

Publishes a video to TikTok by pulling it from a public URL. TikTok downloads the video from the provided URL and publishes it directly to the creator's profile. Publishing is asynchronous — after calling this action, poll TIKTOK_FETCH_PUBLISH_STATUS with the returned publish_id to check completion. For uploading video files instead of URLs, use TIKTOK_UPLOAD_VIDEO.

Upload video

Uploads a video to TikTok via the Content Posting API (init + single-part upload). This action initializes an upload session to obtain a presigned upload URL, then uploads the entire file with a single PUT request. Use a subsequent action to publish the post. Ensure the video file is fully generated and available before calling this action.

Upload videos (batch)

Uploads multiple videos to TikTok concurrently (init + single-part upload per file).

Frequently asked questions

What can I automate with Tiktok on Definable?

Anything Tiktok exposes through its API. Common social media accounts workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 10 Tiktok tools directly, then chain the result into another integration without you writing code.

How does Tiktok authentication work?

Tiktok uses OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Tiktok integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 10 Tiktok tools. You only need a separate Tiktok subscription if Tiktok itself charges per seat or per API call.

Is using Tiktok through Definable secure?

Every call from a persona to Tiktok is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Tiktok on Definable?

Sign up for Definable, open the integrations page, find Tiktok, and connect via OAuth or API key. You can immediately attach Tiktok to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Tiktok actions does Definable expose?

Definable exposes all 10 Tiktok actions as callable tools — including `Fetch publish status`, `Get action categories`, `Get terms`, plus 7 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Tiktok?

Wire it up in minutes. No coding required.

← All integrations