# Mobile - Definir/limpar PIN 2FA da conta

`POST /instance/account/2fa`

Pasta: **Instancia**

## Autenticação

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

## Descrição

# Definir ou limpar PIN 2FA da conta

Define o PIN de verificação em duas etapas da conta mobile. Envie `code` vazio para limpar/desativar.

Use para proteger a conta ou remover o PIN existente.

## Endpoint

```http
POST {{baseUrl}}/instance/account/2fa
```

## Autenticação

Header da instância:

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

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `code` | string | Sim* | PIN de 6 dígitos. String vazia limpa o 2FA. |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/instance/account/2fa" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "123456"
}'
```

## Resposta de Sucesso

```json
{
  "success": true
}
```

## Erros comuns

- `401` — header `token` ausente ou inválido
- `400` — JSON inválido
- `500` — modo não-mobile ou socket offline

## Observações

*O campo é obrigatório no JSON; valor `""` desativa o PIN.

## Corpo (exemplo)

```json
{
  "code": "123456"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/account/2fa" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "123456"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/mobile-definir-limpar-pin-2fa-da-conta)