Skip to main content

TikTok

Read user profiles and videos, and publish video and photo posts via the TikTok Open Platform.

What you can ask​

  • Publish a video from a URL to the authenticated creator's account.
  • Post a photo carousel and track its publishing status until it completes.
  • List the authenticated user's public videos and pull details for specific IDs.

Set up​

TikTok needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find TikTok. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the TikTok developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or TikTok login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (5)

Grant the scopes for the tools you plan to allow.

  • user.info.basic
  • user.info.profile
  • user.info.stats
  • video.list
  • video.publish

Tools​

TikTok offers 8 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (6)​

View and search information without changing it.

ToolWhat it does
get_creator_infoGet the authenticated creator's posting settings: available privacy levels, max video duration, and duet/stitch/comment defaults.
get_post_statusCheck the publishing status of a TikTok post by publish_id.
get_userGet the authenticated TikTok user's profile: display name, avatar, bio, follower/following counts, and verification status.
get_videosRetrieve specific TikTok videos by their IDs (up to 20 at a time).
list_videosList the authenticated user's public TikTok videos, sorted by creation date descending.
validate_credentialValidate TikTok Open Platform OAuth credentials by calling the user info endpoint.

Write (2)​

Create or send data.

ToolWhat it does
init_photo_postInitialize a TikTok photo carousel post with up to 35 photo URLs.
init_video_postInitialize a TikTok video post.
⌘J