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"
}
}
Phones
Create Phone
Provision a new phone for running TikTok/Instagram accounts
POST
/
v1
/
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, ZAResponse
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"
}
}