# Mobile - Verificar código de sincronização

`POST /instance/mobile/verify-code`

Pasta: **Instancia**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Verificar código de sincronização

Confirma o código SMS/ligação/OTP e conclui o vínculo da conta mobile (ou avança para 2FA se a conta exigir).

Use após receber o código do `request-code`.

## Endpoint

```http
POST {{baseUrl}}/instance/mobile/verify-code
```

## Autenticação

Header da instância:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `code` | string | Sim | Código de verificação recebido. |
| `phone` | string | Não | Número com DDI; se omitido, usa o `owner` da instância. |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/instance/mobile/verify-code" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "123456",
  "phone": "5511999999999"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": "Conta vinculada e conectada. Use POST /send/text para enviar mensagens.",
  "instance": {
    "status": "connected",
    "verification_state": "verified",
    "owner": "5511999999999",
    "connection_mode": "mobile"
  },
  "runtime": {
    "present": true,
    "connected": true,
    "logged_in": true
  }
}
```

## Erros comuns

- `400` — `code` ausente ou instância não-mobile
- `409` — código inválido, 2FA necessário (`twoFactorRequired`) ou telefone divergente
- `503` — mobile bridge indisponível

## Observações

Resposta HTTP `202 Accepted`. Se a conta tiver 2FA, a API pode responder com `twoFactorRequired` e métodos disponíveis.

## Corpo (exemplo)

```json
{
  "code": "123456",
  "phone": "5511999999999"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/mobile/verify-code" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "123456",
  "phone": "5511999999999"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/mobile-verificar-codigo-de-sincronizacao)