Follow creator
Follows a library creator in the workspace, as the Follow button on their page does: their new library videos then show in List followed videos and on the app's Track page. Only creators with videos in the library can be followed. Following a creator already followed succeeds and changes nothing. Answers how many creators the organization follows and how many its plan allows, across its workspaces. Needs a plan that includes follows, under its cap (402 plan_limit otherwise). Same as the MCP tool follow_creator. Never counted against the allowance, as its MCP tool; the account still needs a plan (402 no_plan without one).
/api/v1/creators/{handle}/followAuthentication
OAuth token, API key or signed-in session, sent as Authorization: Bearer <token> (a session rides on its cookie). An OAuth token needs mcp:read and mcp:write. See authentication.
Path parameters
handlestringrequiredThe creator's TikTok or Instagram handle, with or without @ (URL-encoded: %40), as List videos and Search library return it, e.g. "creatorname". 1 to 60 characters.
Query parameters
platformenumOptional: the creator's platform, when the handle is on both. One of
tiktok,instagram.workspacestringOptional: the workspace's id or exact name, from List workspaces. Without it, the current workspace (the one the account last opened in the app). Every answer names the workspace it acted in. 1 to 120 characters.
Response fields
creatorobjectWith
handle,platform.followingbooleanfollowsintegerOn a follow: how many creators the organization follows, across its workspaces.
limitintegerOn a follow: how many its plan allows.
urlstring (uri)The creator's page, or the following page, in the app.
workspaceobjectThe workspace the request read or changed.
Responses
- 200
Follow a creator's new videos. Body:
Follow. - 400
The JSON body, an id in the path or a query parameter (
workspaceincluded) is not valid;detailnames it. Body:Problem. - 401
No account: send an API key, an OAuth access token or a session cookie. WWW-Authenticate names the protected-resource metadata. Body:
Problem. - 402
no_plan: the account has no plan, and the API comes with one.plan_limit: what this asks is not included in the account's current plan (saving videos, boards, share links or following creators), or the organization follows as many creators as its plan allows; showdetailandresolutionto the person. Body:Problem. - 403
forbidden: the token lacks mcp:write (WWW-Authenticate carries the insufficient_scope step-up naming mcp:read mcp:write), a session call came from another site, or the account can read this workspace but not change it.workspace_locked: the workspace is past the plan's workspaces, so nothing was read or changed; use an open one (List workspaces marks the locked ones). Body:Problem. - 404
The library has no creator with that handle.
workspace_not_found: the organization has no workspace with that id or name (List workspaces lists them). Body:Problem. - 429
Rate limit exceeded; wait Retry-After seconds. Body:
Problem. - 500
The request failed on our side. Body:
Problem.