Create Cloud Phone

Fresh

Create V2 (Recommended)

The V2 endpoint supports model selection and more flexible configuration.

URL: https://openapi.geelark.com/open/v1/phone/addNewMethod: POST

Request Parameters

Parameter	Required	Type	Description	Example
mobileType	Yes	string	Android version	Android 12
chargeMode	No	int	0=on-demand, 1=monthly (default: on-demand)	0
region	No	string	Cloud phone location: cn, sgp, us (Android 15 only)	cn
data	Yes	array[EnvRowApi]	Environment parameters (max 100)	See below

Environment Parameters (EnvRowApi)

Parameter	Required	Type	Description
profileName	Yes	string	Cloud phone name
proxyInformation	No	string	Proxy info (e.g., socks5://user:pass@host:port)
refreshUrl	No	string	Proxy refresh URL
proxyNumber	No	integer	Serial number of added proxy
dynamicProxy	No	string	Dynamic proxy provider (IPHTML, kookeey, Luminati, etc.)
dynamicProxyLocation	No	string	Dynamic proxy country code
mobileRegion	No	string	Cloud phone region (e.g., USA-US)
mobileProvince	No	string	State (US only)
mobileCity	No	string	City (US only)
mobileLanguage	No	string	Language (baseOnIP, default, or custom)
profileGroup	No	string	Group name (auto-created if new)
profileTags	No	array[string]	Tag names (auto-created if new)
profileNote	No	string	Remark
surfaceBrandName	No	string	Phone brand (from brand list API)
surfaceModelName	No	string	Phone model (from brand list API)
netType	No	integer	0=Wi-Fi, 1=Mobile (Android 12/13/15 only)
phoneNumber	No	string	Custom phone number
phoneName	No	string	Device name (not Android 9/11)

Request Example

{
  "mobileType": "Android 12",
  "chargeMode": 0,
  "data": [
    {
      "profileName": "myPhone",
      "proxyInformation": "socks5://AD00xx004:3000xxx0002@100.200.200.100:30000",
      "mobileLanguage": "default",
      "profileGroup": "myGroup",
      "profileTags": ["myTag"],
      "profileNote": "remark"
    }
  ]
}

Response Example

{
  "traceId": "123456ABCDEF",
  "code": 0,
  "msg": "success",
  "data": {
    "totalAmount": 1,
    "successAmount": 1,
    "failAmount": 0,
    "details": [
      {
        "index": 1,
        "code": 0,
        "msg": "success",
        "id": "497652752864775437",
        "profileName": "22 ungrouped",
        "envSerialNo": "22",
        "equipmentInfo": {
          "countryName": "Thailand",
          "phoneNumber": "+66877382166",
          "enableSim": 1,
          "imei": "863406055475987",
          "osVersion": "Android 11.0",
          "wifiBssid": "1C:1D:67:B1:C1:76",
          "mac": "9C:A5:C0:5F:C5:AD",
          "bluetoothMac": "D0:15:4A:5B:7E:AE",
          "timeZone": "Asia/Bangkok"
        }
      }
    ]
  }
}

Response Fields

Field	Type	Description
totalAmount	integer	Total cloud phones created
successAmount	integer	Successful creations
failAmount	integer	Failed creations
details[].id	string	Cloud phone ID
details[].profileName	string	Cloud phone name
details[].envSerialNo	string	Serial number
details[].equipmentInfo	object	Device info (country, IMEI, MAC, etc.)

Error Codes

Code	Description
44001	Batch creation not allowed (upgrade to Pro)
44002	Cloud phone creation limit reached
44004	Maximum daily creation limit reached
43029	Selected model under maintenance
45005	Incorrect time zone setting

---

Create (Deprecated)

Deprecated

Use Create V2 instead. This endpoint has limited features.

URL: https://openapi.geelark.com/open/v1/phone/addMethod: POST

Request Parameters

Parameter	Required	Type	Description	Example
amount	Yes	integer	Number of phones to create (1-100)	10
androidVersion	Yes	integer	Version code (1=10, 2=11, 3=12, 4=13, 7=14, 8=15)	3
proxyId	No	string	Existing proxy ID
proxyConfig	No	object	Proxy configuration	See below
remark	No	string	Remarks (max 1500 chars)
groupName	No	string	Group name (max 50 chars)
tagsName	No	array[string]	Tag names
region	No	string	cn, sgp, us
chargeMode	No	int	0=per minute, 1=monthly
language	No	string	baseOnIP or default (English)
netType	No	integer	0=Wi-Fi, 1=Mobile
phoneNumber	No	string	Custom phone number

Android Version Codes

Code	Version
1	Android 10
2	Android 11
3	Android 12
4	Android 13
5	Android 10 Live Streaming (monthly only)
7	Android 14
8	Android 15

Static Proxy Config

Parameter	Required	Type	Description
typeId	Yes	integer	1=socks5, 2=http, 3=https
server	Yes	string	Proxy hostname
port	Yes	integer	Proxy port
username	Yes	string	Username
password	Yes	string	Password

Dynamic Proxy Config

Parameter	Required	Type	Description
useProxyCfg	Yes	bool	Use pre-configured proxy
typeId	Yes	integer	20=IPIDEA, 21=IPHTML, 22=kookeey, 23=Lumatuo
protocol	No	integer	1=SOCKS5, 2=HTTP
server	No	string	Proxy hostname
port	No	integer	Proxy port
username	No	string	Username
password	No	string	Password
country	No	string	Country code

Request Example

{
  "amount": 5,
  "androidVersion": 1,
  "proxyConfig": {
    "typeId": 1,
    "server": "server.com",
    "port": 32080,
    "username": "123465ABCD",
    "password": "123465ABCD"
  },
  "groupName": "group",
  "tagsName": ["123", "ABC"],
  "remark": ""
}