### Create Cloud Phone Request Example

Source: https://telegra.ph/Geelark-OpenAPI--Cloud-Phone-Creation-12-17/index

Example JSON payload for creating a single cloud phone with specified profile name, proxy, language, group, tags, and note. This demonstrates the structure for the 'data' array in the request.

```json
{
  "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"
    }
  ]
}
```

--------------------------------

### POST /open/v1/phone/addNew

Source: https://telegra.ph/Geelark-OpenAPI--Cloud-Phone-Creation-12-17/index

Creates one or more cloud phones (Android virtual devices) with isolated profiles. The number of phones that can be created in a single request depends on the user's plan (Basic plan: 1, Pro plan: up to 100).

```APIDOC
## POST /open/v1/phone/addNew

### Description
Creates one or more cloud phones (Android virtual devices) with isolated profiles. Supports single creation for Basic plan users and batch creation (up to 100) for Pro plan users.

### Method
POST

### Endpoint
https://openapi.geelark.com/open/v1/phone/addNew

### Parameters
#### Request Body
- **mobileType** (string) - Required - Android OS version of the cloud phone. Supported values: Android 9, Android 10, Android 11, Android 12, Android 13, Android 14, Android 15.
- **chargeMode** (integer) - Optional - Billing mode. 0 for on-demand (default), 1 for monthly.
- **region** (string) - Optional - Datacenter region. Supported values: cn, sgp. Defaults to 'cn'.
- **data** (array[EnvRowApi]) - Required - Array of cloud phone environment definitions. Maximum 100 items per request.

### EnvRowApi (Cloud Phone Environment)
- **profileName** (string) - Required - Human-readable cloud phone name.
- **proxyInformation** (string) - Optional - Proxy connection string (e.g., http, https, socks5).
- **refreshUrl** (string) - Optional - URL used to refresh proxy IP.
- **proxyNumber** (integer) - Optional - Serial number of a previously added proxy.
- **dynamicProxy** (string) - Optional - Reference to a saved dynamic proxy provider (e.g., IPIDEA, Luminati).
- **dynamicProxyLocation** (string) - Optional - Country code for dynamic proxy location. Required if `dynamicProxy` is set.
- **mobileLanguage** (string) - Optional - Language setting of the cloud phone. Values: `baseOnIP` (derived from proxy), `default` (English).
- **profileGroup** (string) - Optional - Profile group name. Created automatically if it does not exist.
- **profileTags** (array[string]) - Optional - Profile tags. Tags are created automatically if they do not exist.
- **profileNote** (string) - Optional - Free-form remark.
- **surfaceBrandName** (string) - Optional - Device brand. Must match the selected Android version and be used with `surfaceModelName`.
- **surfaceModelName** (string) - Optional - Device model. Must match the selected Android version.
- **netType** (integer) - Optional - Network type. 0 for Wi-Fi, 1 for Mobile network. Only supported on Android 12/13/15. Defaults to Mobile network.
- **phoneNumber** (string) - Optional - Phone number assigned to the cloud phone. Automatically generated if omitted.

### Request Example
```json
{
  "mobileType": "Android 12",
  "chargeMode": 0,
  "data": [
    {
      "profileName": "myPhone",
      "proxyInformation": "socks5://user:pass@ip:port",
      "mobileLanguage": "default",
      "profileGroup": "myGroup",
      "profileTags": ["myTag"],
      "profileNote": "remark"
    }
  ]
}
```

### Response
#### Success Response (200)
- **traceId** (string) - Unique identifier for the request trace.
- **code** (integer) - Status code. 0 indicates success.
- **msg** (string) - Success message.
- **data** (object) - Contains creation results.
  - **totalAmount** (integer) - Total number of cloud phones requested.
  - **successAmount** (integer) - Number of successfully created cloud phones.
  - **failAmount** (integer) - Number of failed cloud phone creations.
  - **details** (array) - Per-phone creation results.

#### Response Example
```json
{
  "traceId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "code": 0,
  "msg": "success",
  "data": {
    "totalAmount": 1,
    "successAmount": 1,
    "failAmount": 0,
    "details": [
      {
        "profileName": "myPhone",
        "success": true,
        "message": "Phone created successfully."
      }
    ]
  }
}
```
```

--------------------------------

### Cloud Phone Creation Response Structure

Source: https://telegra.ph/Geelark-OpenAPI--Cloud-Phone-Creation-12-17/index

The standard response structure for cloud phone creation requests via the Geelark OpenAPI. Includes a trace ID, status code, message, and a data object containing creation summary and details.

```json
{
  "traceId": "string",
  "code": 0,
  "msg": "success",
  "data": { ... }
}
```

--------------------------------

### Cloud Phone Creation Response Data Details

Source: https://telegra.ph/Geelark-OpenAPI--Cloud-Phone-Creation-12-17/index

The structure of the 'data' object within the API response, detailing the total number of requested phones, successfully created, and failed creations, along with individual creation results.

```json
{
  "totalAmount": integer,
  "successAmount": integer,
  "failAmount": integer,
  "details": array
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.