Gerenciar 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.
• Confira quanto espaço a lista tem. O limite conta todos os inscritos, incluindo os descadastrados. Consulte Limites.
• Para a API, use uma chave de API com Full Access.

Adicionar um inscrito

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" }
  }'

{
  "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"
}

Quando a pessoa já está na lista

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

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.

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. 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:

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.

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.

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.

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 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:

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 com o ID sub_ ou o endereço de e-mail.

Veja também