Skip to navigation
API Referencefarm-profiles

Follow an account from a farm profile

Queues the farm profile to follow another TikTok account. The phone opens TikTok, follows the target handle, then performs a short burst of organic activity to look natural. The response returns immediately; the follow runs on the cloud phone in the background and may take a few minutes.

Preconditions:

  • The profile must have a provisioned phone and be idle (cold, warm, or ready). If it’s mid-warmup, mid-post, or already running a follow, the request is rejected with 409; wait and retry.
  • Each profile can follow at most 5 accounts per rolling 24-hour window. The 6th within that window returns 429 until the window rolls over.

Webhook: if you pass webhook_url, we POST {event: 'follow.completed', phone_id, username} to it once the follow finishes on the device. Fired only on success; no retries.

Rate limit: 10 requests per minute per team.

Authentication

X-API-Keystring
API Key authentication via header

Path parameters

profile_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.
usernamestringRequired

The TikTok handle for the profile to follow, without the leading @ (stripped if included). The phone opens TikTok, follows this account, then performs a short burst of organic activity.

webhook_urlstring or nullOptional

Optional HTTPS URL we’ll POST {event: 'follow.completed', phone_id, username} to once the follow finishes on the device. Fire-and-forget; no retries.

Response

Successful Response
profile_idstring
The farm profile that performed the follow.
usernamestring

The handle that was followed, normalized without a leading @.

status"queued"

Always queued on success; the follow runs asynchronously on the cloud phone.

Errors

404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
502
Bad Gateway Error