Skip to main content
POST
/
v1
/
accounts
/
{accountId}
/
warmup
/
start
curl -X POST https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/warmup/start \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "duration": 7,
    "keywords": ["fashion", "ootd", "style"]
  }'

{
  "accountId": "acc_1a2b3c4d5e",
  "platform": "tiktok",
  "warmupStatus": {
    "enabled": true,
    "startedAt": "2024-04-21T20:00:00Z",
    "completionDate": "2024-04-28T20:00:00Z",
    "duration": 7,
    "keywords": ["fashion", "ootd", "style"]
  }
}

​
Path Parameters

​
accountId
string
required
The unique account identifier.

​
Request Body

​
duration
number
default:"7"
Number of days for the warmup process (3-14 days).
​
keywords
array
Array of keywords to use for content discovery during warmup (e.g., ["fashion", "style", "outfit"]).Default: Platform-appropriate trending keywords.

​
Response

​
accountId
string
The account identifier.
​
platform
string
Platform: tiktok or instagram.
​
warmupStatus
object
Warmup configuration and status.
curl -X POST https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/warmup/start \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "duration": 7,
    "keywords": ["fashion", "ootd", "style"]
  }'

{
  "accountId": "acc_1a2b3c4d5e",
  "platform": "tiktok",
  "warmupStatus": {
    "enabled": true,
    "startedAt": "2024-04-21T20:00:00Z",
    "completionDate": "2024-04-28T20:00:00Z",
    "duration": 7,
    "keywords": ["fashion", "ootd", "style"]
  }
}
What Happens During Warmup?The warmup process gradually ramps up engagement to mimic authentic user behavior and avoid platform restrictions:
  • Early Days: Light engagement (views, likes)
  • Mid-Point: Follows and comments begin
  • Later Days: Full engagement patterns established
For TikTok: Username can be set after Day 5 of warmup.

​
Error Responses

Unauthorized
{
  "error": {
    "code": "unauthenticated",
    "message": "Invalid or missing API key"
  }
}
Account Not Found
{
  "error": {
    "code": "not_found",
    "message": "Account acc_1a2b3c4d5e not found"
  }
}
Warmup Already Active
{
  "error": {
    "code": "warmup_already_active",
    "message": "Warmup is already active for this account"
  }
}
Server Error
{
  "error": {
    "code": "internal",
    "message": "An unexpected error occurred"
  }
}