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 '{
    "quantity": 5,
    "region": "us"
  }'

{
  "phones": [
    {
      "id": "phone_abc123",
      "geelarkPhoneId": "557536075321468390",
      "status": "provisioning",
      "region": "us",
      "createdAt": "2024-04-21T20:00:00Z"
    },
    {
      "id": "phone_def456",
      "geelarkPhoneId": "557536075321468391",
      "status": "provisioning",
      "region": "us",
      "createdAt": "2024-04-21T20:00:00Z"
    }
  ]
}

​
Request Body

​
quantity
number
default:"1"
Number of phones to create (1-100).
​
region
string
default:"us"
Geographic region for the cloud phone. Currently only us is supported.

​
Response

​
phones
array
Array of created phone objects.
curl -X POST https://api.infinipost.co/v1/phones \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 5,
    "region": "us"
  }'

{
  "phones": [
    {
      "id": "phone_abc123",
      "geelarkPhoneId": "557536075321468390",
      "status": "provisioning",
      "region": "us",
      "createdAt": "2024-04-21T20:00:00Z"
    },
    {
      "id": "phone_def456",
      "geelarkPhoneId": "557536075321468391",
      "status": "provisioning",
      "region": "us",
      "createdAt": "2024-04-21T20:00:00Z"
    }
  ]
}

​
Provisioning Process

  1. Request Submitted (instant): Phone provisioning requests are queued
  2. Infrastructure Allocation (30-90 seconds): Cloud phone resources are allocated
  3. Status Update: Phone status changes from provisioning to ready
  4. Ready for Accounts: Once ready, you can create TikTok/Instagram accounts on the phone
Phones are automatically configured with US-based proxies and proper device fingerprints to avoid platform detection.

​
Error Responses

Phone Limit Reached
{
  "error": {
    "code": "phone_limit_exceeded",
    "message": "You have reached your phone limit. Upgrade your plan to provision more phones."
  }
}
Invalid Quantity
{
  "error": {
    "code": "invalid_quantity",
    "message": "Quantity must be between 1 and 100"
  }
}
Invalid Region
{
  "error": {
    "code": "invalid_region",
    "message": "Region 'eu' is not supported. Currently only 'us' is available."
  }
}