Create a farm profile

Provisions a new farm account under your team. This creates a cloud phone, rents an SMS number, and queues account signup as a background task.

Each successful provisioning increments your monthly billing quantity. Pricing follows volume tiers — the more accounts you have, the lower the per-account rate.

Authentication

X-API-Keystring
API Key authentication via header

Request

This endpoint expects an object.
platformstringRequired

Target social platform for the new account (e.g. tiktok).

usernamestringRequired
Desired handle for the new account.
keywordslist of stringsOptional
Warmup keywords used to seed organic browsing on the device.

Response

Successful Response
task_idstring
Background task ID running the provisioning job.
usernamestring
The handle being provisioned.

Errors

402
Payment Required Error
422
Unprocessable Entity Error
502
Bad Gateway Error