# Criando um perfil de telefone na nuvem

Compra e provisiona um ou mais Cloud Phones.
- **Pré-requisitos**: o plano precisa ter capacidade restante e a cota diária de criação não pode estar esgotada. `country`, `timezone` e `language` são validados contra a lista suportada pelo serviço escolhido, portanto uma combinação não suportada é rejeitada em vez de ajustada silenciosamente. As coordenadas são limitadas a ±180 de longitude e ±90 de latitude. O número de telefone é descartado quando o SKU escolhido não suporta um. SKUs mensais podem ser criados pela API quando retornados por [`/api/cloudphone/monthly/skus`](./local-api.yaml#operation/listMonthlyCloudPhoneSkus); o período atual é de 30 dias.
- **Efeito**: cria os registros de Cloud Phone. SKUs por minuto ficam disponíveis após o provisionamento; os mensais são criados inativos. A criação não cobra: telefones mensais só são cobrados por [`/api/cloudphone/monthly/activate`](./local-api.yaml#operation/activateMonthlyCloudPhones), enquanto os de cobrança por minuto começam a consumir saldo ou cota ao serem ligados.
- **Conclusão**: **aceito, não concluído.** A instância do serviço ainda não está pronta, e ligá-la cedo demais é rejeitado. Consulte [`/api/cloudphone/info`](./local-api.yaml#operation/infoUsingPOST) ou [`/api/cloudphone/page`](./local-api.yaml#operation/pageUsingPOST) até que `envStatus` informe que o telefone está desligado. Para um SKU mensal, conclua também [`/api/cloudphone/monthly/activate`](./local-api.yaml#operation/activateMonthlyCloudPhones) antes de ligá-lo.
- **Nova tentativa**: não é idempotente nem serializada. Não há chave de idempotência. Não repita às cegas depois de um timeout: consulte o estado primeiro.

Erros de negócio documentados: `19064`, `20018`, `33338`, `33339`, `33340`, `33341`, `33342`, `33343`, `33344`, `33345`, `33398`, `33399`, `33400`, `33408`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Endpoint: POST /api/cloudphone/create
Version: 2026-09-05

## Request fields (application/json):

  - `skuId` (string, required)
    Modelo do Cloud Phone
| Modelo do Cloud Phone | SKU ID (`skuId`) |
|  --- | --- |
| Android 12 | `10002` |
| Android 13 | `10013` |
| Android 14 | `10005` |
| Android 15 | `10004` |
| Android 15A | `10014` |
| Android 16 | `10015` |
| Android 17 | `10105` |

Consulte a [tabela de países e fusos horários](/api-reference/appendix/country-time-zone) para ver as regiões suportadas e o mapeamento de fusos horários

  - `quantity` (integer, required)
    Quantidade de Cloud Phones criados. Faixa de valores: [1-10]

  - `envRemark` (string)
    Observação do perfil (limite de 1500 caracteres)

  - `groupId` (string)
    ID do grupo. Use `"0"` para sem grupo.

  - `groupName` (string)
    Nome de um grupo existente, ou o nome de um novo grupo a ser criado quando nenhum corresponder.

  - `automaticGeo` (boolean)
    Se a localização geográfica deve ser correspondida automaticamente. Padrão: true

  - `automaticLanguage` (boolean)
    Se o idioma deve ser correspondido automaticamente. Padrão: true

  - `automaticLocation` (boolean)
    Se a localização (fuso horário, país) deve ser correspondida automaticamente. Padrão: true

  - `country` (string)
    Código do país (por exemplo `us`). Consulte a [tabela de países e fusos horários](/api-reference/appendix/country-time-zone) para ver a lista completa

  - `timezone` (string)
    Fuso horário, por exemplo America/New_York

  - `language` (string)
    Idioma, por exemplo en-US

  - `altitude` (number)
    Altitude

  - `latitude` (number)
    Latitude. Exemplo: 22.309182

  - `longitude` (number)
    Longitude. Exemplo: 114.176817

  - `speed` (number)
    Velocidade de movimento

  - `bearing` (number)
    Direção do movimento

  - `accuracy` (number)
    Precisão horizontal

  - `phoneNumber` (string)
    Número de telefone personalizado. Requisitos de formato: precisa começar com um sinal +, o código do país precisa ter de 1 a 3 dígitos (excluindo 86), o comprimento total precisa ter de 8 a 14 dígitos e só pode conter + e números.

  - `brand` (string)
    Marca do dispositivo. Você pode consultá-la pela interface https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

  - `modelId` (number)
    ID do modelo do dispositivo. Você pode consultá-lo pela interface https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

  - `proxyId` (string)
    ID do proxy

  - `tags` (array)
    Nomes de etiquetas. Valores vazios são ignorados.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)

  - `msg` (string | null, required)

  - `data` (array)
    Este é o ID do telefone na nuvemS

  - `requestId` (string, required)

  - `error` (object)