# Mobile - Solicitar OTP por e-mail (2FA)

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

Pasta: **Instancia**

## Autenticação

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

## Descrição

# Solicitar OTP por e-mail (2FA de registro)

Pede o envio do código OTP para o e-mail vinculado quando o segundo fator do **registro** exige e-mail.

Use quando `second_factor_methods` incluir e-mail após o verify-code.

## Endpoint

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

## 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 (SMS/call/otp). |
| `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" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "123456",
  "phone": "5511999999999"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": "Email OTP solicitado. Verifique o email e use POST /instance/mobile/two-factor/email/verify",
  "raw": {}
}
```

## Erros comuns

- `400` — `code` ausente ou modo não-mobile
- `409` — conta sem e-mail / rate limit WhatsApp
- `503` — mobile bridge indisponível

## Observações

Resposta HTTP `202 Accepted`. Em seguida chame `/two-factor/email/verify`.

## Corpo (exemplo)

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

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/mobile/two-factor/email" \
  -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-solicitar-otp-por-e-mail-2fa)