Skip to main content
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"
  }'

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

​
Request Body

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

​
Response

​
success
boolean
Whether the phone was created successfully (true or false).
​
phoneId
string
Unique identifier for the phone.
​
phoneSlot
number
The assigned phone slot number.
​
proxyId
string
ID of the proxy assigned to this phone.
​
status
string
Current status: pending_setup, ready, or failed.
​
message
string
Success message confirming phone creation.
​
createdAt
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"
  }'

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

​
Provisioning Process

  1. Request Submitted (instant): Phone provisioning request is queued
  2. Phone Slot Assignment: System assigns next available phone slot
  3. 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"
  }
}