# Mobile - Confirmar OTP do e-mail (2FA)

`POST /instance/mobile/two-factor/email/verify`

Pasta: **Instancia**

## Autenticação

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

## Descrição

# Confirmar OTP do e-mail (2FA de registro)

Confirma o código recebido por e-mail junto com o código original de verificação e finaliza o login mobile.

Use após `POST /instance/mobile/two-factor/email`.

## Endpoint

```http
POST {{baseUrl}}/instance/mobile/two-factor/email/verify
```

## Autenticação

Header da instância:

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

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `code` | string | Sim | Código original da verificação. |
| `email_code` | string | Sim | Código recebido no e-mail. |
| `phone` | string | Não | Número com DDI; padrão = `owner`. |

## Exemplo de Requisição

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

## Resposta de Sucesso

```json
{
  "success": true,
  "message": "Verificacao via email concluida. Conta vinculada e conectada.",
  "instance": {
    "status": "connected",
    "verification_state": "verified",
    "connection_mode": "mobile"
  },
  "runtime": {
    "present": true,
    "connected": true,
    "logged_in": true
  }
}
```

## Erros comuns

- `400` — `code`/`email_code` ausente ou modo não-mobile
- `409` — códigos inválidos
- `503` — mobile bridge indisponível

## Observações

Resposta HTTP `202 Accepted`.

## Corpo (exemplo)

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

## cURL

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

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/mobile-confirmar-otp-do-e-mail-2fa)