> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/newsletter/cadastrar-newsletter.md).

# Cadastrar Newsletter

Cadastra um **novo inscrito** na newsletter da loja.

```
POST /newsletter/
```

## 📋 Campos

| Campo    | Tipo  | Obrigatório | Descrição                                             |
| -------- | ----- | ----------- | ----------------------------------------------------- |
| `Status` | texto | ✅ Sim       | Status do inscrito: `A` (Ativado) ou `D` (Desativado) |
| `Email`  | texto | ✅ Sim       | E-mail do inscrito                                    |
| `Nome`   | texto | ❌ Não       | Nome do inscrito                                      |

## 📥 Exemplo de requisição

```bash
curl -X POST "https://api.toplojas.com.br/newsletter/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]" \
  -H "Content-Type: application/json" \
  -d '{
    "Status": "A",
    "Nome": "teste2",
    "Email": "teste2@google.com.br"
  }'
```

Em caso de sucesso, a API retorna o HTTP Code **201**.

{% hint style="info" %}
Referência completa deste endpoint:

{% embed url="<https://api.toplojas.com.br/doc/#/Newsletter>" %}
{% endhint %}