Skip to main content
POST
/
v1
/
accounts
curl -X POST https://api.infinipost.co/v1/accounts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "tiktok",
    "name": "Fashion Insider",
    "bio": "Daily fashion tips and trends 👗",
    "autoStartWarmup": true
  }'

{
  "id": "acc_1a2b3c4d5e",
  "platform": "tiktok",
  "name": "Fashion Insider",
  "username": null,
  "bio": "Daily fashion tips and trends 👗",
  "status": "pending",
  "warmupStatus": {
    "enabled": true,
    "currentDay": 1
  },
  "createdAt": "2024-04-21T19:30:00Z"
}

​
Request Body

​
platform
string
required
The platform to create an account on. Either tiktok or instagram.
​
name
string
required
The display name for the account (e.g., “John Smith”).
​
username
string
The desired username. If not provided, one will be auto-generated.Note: TikTok usernames can only be set after Day 5 of warmup.
​
bio
string
Account bio/description.
​
profilePictureUrl
string
URL of the profile picture to use. Must be a publicly accessible image URL.
​
autoStartWarmup
boolean
default:"false"
Automatically start the warmup process after account creation.

​
Response

​
id
string
Unique identifier for the account.
​
platform
string
The platform (tiktok or instagram).
​
name
string
The account’s display name.
​
username
string
The account’s username (may be null for new TikTok accounts).
​
status
string
Current status: pending, active, warmup, or failed.
​
createdAt
string
ISO 8601 timestamp of when the account was created.
​
warmupStatus
object
Warmup configuration and status.
curl -X POST https://api.infinipost.co/v1/accounts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "tiktok",
    "name": "Fashion Insider",
    "bio": "Daily fashion tips and trends 👗",
    "autoStartWarmup": true
  }'

{
  "id": "acc_1a2b3c4d5e",
  "platform": "tiktok",
  "name": "Fashion Insider",
  "username": null,
  "bio": "Daily fashion tips and trends 👗",
  "status": "pending",
  "warmupStatus": {
    "enabled": true,
    "currentDay": 1
  },
  "createdAt": "2024-04-21T19:30:00Z"
}

​
Account Creation Process

  1. Provisioning (30-60 seconds): Cloud phone infrastructure is allocated
  2. Account Setup (60-120 seconds): TikTok/Instagram account is created
  3. Status Update: Account status changes from pending to active
  4. Warmup (optional): If autoStartWarmup is true, warmup begins immediately
TikTok Username Restriction: New TikTok accounts cannot set a custom username until Day 5 of warmup. The username field will be null until then.

​
Error Responses

{
  "error": {
    "code": "username_taken",
    "message": "The username 'fashioninsider' is already taken"
  }
}