Start Warmup

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"]
  }'

const response = await fetch('https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/warmup/start', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    duration: 7,
    keywords: ['fashion', 'ootd', 'style']
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/warmup/start',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'duration': 7,
        'keywords': ['fashion', 'ootd', 'style']
    }
)

print(response.json())

{
  "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"]
  }
}

POST

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"]
  }'

const response = await fetch('https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/warmup/start', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    duration: 7,
    keywords: ['fashion', 'ootd', 'style']
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/warmup/start',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'duration': 7,
        'keywords': ['fashion', 'ootd', 'style']
    }
)

print(response.json())

{
  "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

string

required

The unique account identifier.

Request Body

number

default:"7"

Number of days for the warmup process (3-14 days).

array

Array of keywords to use for content discovery during warmup (e.g., ["fashion", "style", "outfit"]).Default: Platform-appropriate trending keywords.

Response

string

The account identifier.

string

Platform: tiktok or instagram.

object

Warmup configuration and status.

Show properties

boolean

Always true after starting warmup.

string

ISO 8601 timestamp of when warmup started.

string

ISO 8601 timestamp of when warmup is expected to complete.

number

Total duration in days.

array

Keywords being used for content discovery.

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"]
  }'

const response = await fetch('https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/warmup/start', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    duration: 7,
    keywords: ['fashion', 'ootd', 'style']
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.infinipost.co/v1/accounts/acc_1a2b3c4d5e/warmup/start',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'duration': 7,
        'keywords': ['fashion', 'ootd', 'style']
    }
)

print(response.json())

{
  "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"
  }
}

Phones

Accounts

Warmup

Posts

Media

Engagement

Partners

Path Parameters

Request Body

Response

Error Responses

​Path Parameters

​Request Body

​Response

​Error Responses

Path Parameters

Request Body

Response

Error Responses