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.
- Go to Organization > Connectors and find TikTok. Click Enable, and choose which tools to allow.
- Create an OAuth application in the TikTok developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- 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.basicuser.info.profileuser.info.statsvideo.listvideo.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.
| Tool | What it does |
|---|---|
get_creator_info | Get the authenticated creator's posting settings: available privacy levels, max video duration, and duet/stitch/comment defaults. |
get_post_status | Check the publishing status of a TikTok post by publish_id. |
get_user | Get the authenticated TikTok user's profile: display name, avatar, bio, follower/following counts, and verification status. |
get_videos | Retrieve specific TikTok videos by their IDs (up to 20 at a time). |
list_videos | List the authenticated user's public TikTok videos, sorted by creation date descending. |
validate_credential | Validate TikTok Open Platform OAuth credentials by calling the user info endpoint. |
Write (2)
Create or send data.
| Tool | What it does |
|---|---|
init_photo_post | Initialize a TikTok photo carousel post with up to 35 photo URLs. |
init_video_post | Initialize a TikTok video post. |