Follow an account from a farm profile | Algorhythm

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.

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

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.

$	curl -X POST https://api.algorhythm.app/v1/farm-profiles/f8a1c2d4-3b7e-4f9a-9c2d-1e5b7a8f9c3d/follow \
>	-H "X-API-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"username": "charlidamelio",
>	"webhook_url": "https://example.com/hooks/algorhythm"
>	}'