Create Phone

curl -X POST https://api.infinipost.co/v1/phones \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneName": "My Fashion Account Phone",
    "country": "GB"
  }'

const response = await fetch('https://api.infinipost.co/v1/phones', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phoneName: 'My Fashion Account Phone',
    country: 'GB'
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.infinipost.co/v1/phones',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'phoneName': 'My Fashion Account Phone',
        'country': 'GB'
    }
)

print(response.json())

{
  "success": true,
  "phoneId": "phone_abc123",
  "phoneSlot": 1,
  "proxyId": "proxy_xyz789",
  "status": "pending_setup",
  "message": "Phone created successfully",
  "createdAt": "2024-04-21T20:00:00Z"
}

{
  "success": false,
  "error": {
    "code": "internal",
    "message": "Failed to create phone: Unable to allocate resources"
  }
}

POST

phones

curl -X POST https://api.infinipost.co/v1/phones \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneName": "My Fashion Account Phone",
    "country": "GB"
  }'

const response = await fetch('https://api.infinipost.co/v1/phones', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phoneName: 'My Fashion Account Phone',
    country: 'GB'
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.infinipost.co/v1/phones',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'phoneName': 'My Fashion Account Phone',
        'country': 'GB'
    }
)

print(response.json())

{
  "success": true,
  "phoneId": "phone_abc123",
  "phoneSlot": 1,
  "proxyId": "proxy_xyz789",
  "status": "pending_setup",
  "message": "Phone created successfully",
  "createdAt": "2024-04-21T20:00:00Z"
}

{
  "success": false,
  "error": {
    "code": "internal",
    "message": "Failed to create phone: Unable to allocate resources"
  }
}

Request Body

string

Custom name for the phone (optional). If not provided, a default name will be generated.

string

default:"US"

ISO 3166-1 alpha-2 country code for the phone’s proxy location (e.g. US, GB, DE). Determines where the phone’s IP address appears to be located, which affects what content and audiences are available on TikTok and Instagram. Defaults to US if not provided.Supported values: US, GB, DE, ES, CA, FR, IT, PT, AE, AR, AT, AU, BD, BE, BG, BR, CH, CL, CO, CY, CZ, DK, DZ, EG, FI, GE, GR, HK, HN, HR, HU, ID, IE, IL, IN, JP, KE, KR, KZ, LT, MA, MT, MX, MY, NG, NL, NO, NZ, PE, PH, PK, PL, RO, SA, SE, SG, SK, TH, TR, TW, UA, VN, ZA

Response

boolean

Whether the phone was created successfully (true or false).

string

Unique identifier for the phone.

number

The assigned phone slot number.

string

ID of the proxy assigned to this phone.

string

Current status: pending_setup, ready, or failed.

string

Success message confirming phone creation.

string

ISO 8601 timestamp of when the phone was created.

curl -X POST https://api.infinipost.co/v1/phones \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneName": "My Fashion Account Phone",
    "country": "GB"
  }'

const response = await fetch('https://api.infinipost.co/v1/phones', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phoneName: 'My Fashion Account Phone',
    country: 'GB'
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.infinipost.co/v1/phones',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'phoneName': 'My Fashion Account Phone',
        'country': 'GB'
    }
)

print(response.json())

{
  "success": true,
  "phoneId": "phone_abc123",
  "phoneSlot": 1,
  "proxyId": "proxy_xyz789",
  "status": "pending_setup",
  "message": "Phone created successfully",
  "createdAt": "2024-04-21T20:00:00Z"
}

{
  "success": false,
  "error": {
    "code": "internal",
    "message": "Failed to create phone: Unable to allocate resources"
  }
}

Provisioning Process

Request Submitted (instant): Phone provisioning request is queued
Phone Slot Assignment: System assigns next available phone slot
Infrastructure Allocation (30-90 seconds): Phone resources are allocated

Error Responses

Phone Limit Reached

{
  "error": {
    "code": "resource-exhausted",
    "message": "You've reached your phone limit (5). Please upgrade your plan."
  }
}

User Not Found

{
  "error": {
    "code": "not-found",
    "message": "User not found"
  }
}

API Error

{
  "error": {
    "code": "internal",
    "message": "API error: Unable to allocate resources"
  }
}

Unauthenticated

{
  "error": {
    "code": "unauthenticated",
    "message": "User must be authenticated"
  }
}

Phones

Accounts

Warmup

Posts

Media

Engagement

Partners

Request Body

Response

Provisioning Process

Error Responses

​Request Body

​Response

​Provisioning Process

​Error Responses

Request Body

Response

Provisioning Process

Error Responses