# Gerenciar inscritos

> Adicione pessoas a uma lista de contatos, edite-as, ative ou desative o indicador Subscribed delas e remova-as, no painel ou com a API de inscritos.

Um inscrito é a participação de um contato em uma lista. Esta página mostra como adicionar inscritos, alterá-los, descadastrá-los ou reinscrevê-los e removê-los, e o que cada alteração faz com o contato por trás deles.

## Antes de começar

- Crie a lista primeiro. Consulte [Listas de contatos](/pt/docs/audiences/).
- Confira quanto espaço a lista tem. O limite conta todos os inscritos, incluindo os descadastrados. Consulte [Limites](/pt/docs/audiences/#limits).
- Para a API, use uma chave de API com **Full Access**.

## Adicionar um inscrito

**Painel**

  1. **Abra a lista.** Acesse **Email Marketing → Audiences** e selecione a lista.

  2. **Adicione a pessoa.** Selecione **Add subscriber**, digite o **Email** e, opcionalmente, **First name** e **Last name**.

  3. **Salve.** Selecione **Add**. Se não existir um contato para o endereço, o Emailit cria um.

  Você também pode adicionar contatos existentes em **Email Marketing → Contacts**: abra um contato e selecione **Add to audience**, ou selecione vários contatos e use **Actions > Add to audience**. Para adicionar muitas pessoas de uma vez, [importe um arquivo](/pt/docs/contacts/import-export/).

**API**

  Chame [Adicionar um inscrito](/pt/docs/api-reference/audiences/subscribers/add/) com o ID ou o nome da lista:

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Acme" }
  }'
```

```json
{
  "object": "subscriber",
  "id": "sub_7Rt2vX9kLm3Qp",
  "audience_id": "aud_5hJ2kL8mNp4Qr",
  "contact_id": "con_2kq8Vt4xLm7Rz",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": { "company": "Acme" },
  "subscribed": true,
  "subscribed_at": "2026-10-01T09:30:00Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T09:30:00Z",
  "updated_at": "2026-10-01T09:30:00Z"
}
```

  Apenas `email` é obrigatório. Se você enviar `first_name`, `last_name` ou `custom_fields` para um contato existente, eles sobrescrevem os valores do contato, e `custom_fields` substitui o objeto inteiro.

### Quando a pessoa já está na lista

O resultado de adicionar um endereço que já está na lista depende do estado atual dele:

| Estado atual | Resultado | Resposta da API |
| --- | --- | --- |
| Fora da lista | Um novo inscrito é criado com **Subscribed** ativado. | `201` |
| Na lista, com **Subscribed** ativado | Nada muda. O painel mostra “Contact is already subscribed to this audience”. | `409` com o inscrito em `existing` |
| Na lista, descadastrado | O inscrito é reinscrito: **Subscribed** é ativado, `subscribed_at` passa a ser o horário atual e `unsubscribed_at` é limpo. | `200` |
| A lista está cheia | Nada é adicionado. | `422` com `usage` |

Uma reinscrição por esse endpoint envia os eventos `subscriber.updated` e `subscriber.resubscribed` e inicia automações **Added to audience**, assim como um novo inscrito.

> **Atenção:** Adicionar de novo alguém que se descadastrou reinscreve essa pessoa. Faça isso apenas quando a pessoa pediu para entrar de novo, por exemplo se inscrevendo no seu site.

## Editar um inscrito

Na tabela de inscritos da lista, abra o menu da linha e selecione **Edit**. Você pode alterar **First name**, **Last name** e a opção **Subscribed**. O endereço de e-mail é somente leitura aqui.

Pela API, chame [Atualizar um inscrito](/pt/docs/api-reference/audiences/subscribers/update/). Identifique o inscrito pelo ID `sub_` ou pelo endereço de e-mail e envie qualquer um destes campos: `email`, `first_name`, `last_name`, `custom_fields` e `subscribed`:

```bash
curl https://api.emailit.com/v2/audiences/Newsletter/subscribers/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "Augusta", "subscribed": false }'
```

Nome, sobrenome, e-mail e campos personalizados pertencem ao contato, não ao inscrito. Alterá-los aqui atualiza o contato em todos os lugares, inclusive nas outras listas dele. Apenas `subscribed` é específico desta lista.

## Ativar ou desativar Subscribed

O indicador **Subscribed** define se as campanhas para esta lista chegam à pessoa. Desativá-lo mantém o inscrito na lista, registra `unsubscribed_at` e não mexe nas outras listas do contato. Ativá-lo de novo define um novo `subscribed_at` e limpa `unsubscribed_at`.

| Onde | Descadastrar | Reinscrever |
| --- | --- | --- |
| Página da lista | **Edit** e depois desative **Subscribed** | **Edit** e depois ative **Subscribed** |
| Página do contato | **Unsubscribe** no menu da linha da lista | **Resubscribe** no menu da linha |
| API | [Atualizar um inscrito](/pt/docs/api-reference/audiences/subscribers/update/) com `"subscribed": false` | Atualizar com `"subscribed": true`, ou [adicionar](/pt/docs/api-reference/audiences/subscribers/add/) o endereço de novo |

Essas alterações enviam um evento `subscriber.updated`. Elas não registram um descadastro em nenhuma campanha, então não aparecem na aba **Unsubscribes** de uma campanha. Quando os próprios destinatários se descadastram pelo link de uma campanha, eles saem de todas as listas de uma vez. Consulte [Descadastros](/pt/docs/audiences/unsubscribes/).

## Remover um inscrito

Remover um inscrito exclui a participação na lista. Selecione **Delete** no menu da linha na página da lista, **Remove from audience** na página do contato, ou chame [Excluir um inscrito](/pt/docs/api-reference/audiences/subscribers/delete/).

| | Descadastrar | Remover |
| --- | --- | --- |
| A pessoa continua na lista | Sim, com **Subscribed** desativado | Não |
| Conta para o limite da lista | Sim | Não |
| O contato é mantido | Sim | Sim |
| Evento | `subscriber.updated` | `subscriber.deleted`, que inicia automações **Removed from audience** |
| Adicionar o endereço de novo | Reinscreve o inscrito existente | Cria um novo inscrito |

Prefira descadastrar quando alguém pede para sair, para manter um registro disso. Remova os inscritos que você adicionou por engano ou que não quer mais manter. Para excluir a pessoa por completo, exclua o contato, o que o remove de todas as listas.

## Listar e encontrar inscritos

Na página da lista, pesquise por e-mail ou nome e filtre por Email, First name, Last name, Subscribed ou Created.

Pela API, [Listar inscritos](/pt/docs/api-reference/audiences/subscribers/list/) retorna todos os inscritos, incluindo os descadastrados. Adicione `subscribed=true` ou `subscribed=false` para restringir a lista, `search` para buscar no e-mail ou nos nomes, e `page` e `limit` (até 100) para paginar:

```bash
curl "https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers?subscribed=true&limit=100&page=1" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

Para consultar uma pessoa, use [Obter um inscrito](/pt/docs/api-reference/audiences/subscribers/get/) com o ID `sub_` ou o endereço de e-mail.

## Veja também

  - [URL de inscrição](/pt/docs/audiences/subscribe-url/): Permita que as pessoas se inscrevam pelo seu site.
  - [Contatos](/pt/docs/contacts/): A pessoa por trás de cada inscrito.

---
Fonte: https://emailit.com/pt/docs/audiences/subscribers/