Gestisci gli iscritti

Un iscritto è l’appartenenza di un contatto a una lista. Questa pagina mostra come aggiungere iscritti, modificarli, disiscriverli o reiscriverli e rimuoverli, e cosa comporta ogni modifica per il contatto collegato.

Prima di iniziare

• Crea prima la lista. Vedi Liste.
• Controlla quanto spazio ha la lista. Il limite conta tutti gli iscritti, compresi quelli disiscritti. Vedi Limiti.
• Per l’API, usa una chiave API con Full Access.

Aggiungi un iscritto

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 la persona è già nella lista

Aggiungere un indirizzo già presente nella lista ha un esito diverso a seconda del suo stato attuale:

Una reiscrizione tramite questo endpoint invia gli eventi subscriber.updated e subscriber.resubscribed e avvia le automazioni Added to audience, come per un nuovo iscritto.

Modifica un iscritto

Nella tabella degli iscritti della lista, apri il menu della riga e seleziona Edit. Puoi cambiare First name, Last name e l’interruttore Subscribed. Qui l’indirizzo email è in sola lettura.

Con l’API, chiama Aggiorna un iscritto. Identifica l’iscritto con il suo ID sub_ o con l’indirizzo email e invia uno o più tra 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, cognome, email e campi personalizzati appartengono al contatto, non all’iscritto. Modificarli qui aggiorna il contatto ovunque, anche nelle altre liste in cui si trova. Solo subscribed è specifico di questa lista.

Attiva o disattiva Subscribed

L’indicatore Subscribed decide se le campagne inviate a questa lista raggiungono la persona. Disattivarlo lascia l’iscritto nella lista, registra unsubscribed_at e non tocca le altre liste del contatto. Riattivarlo imposta un nuovo subscribed_at e svuota unsubscribed_at.

Queste modifiche inviano un evento subscriber.updated. Non registrano una disiscrizione su nessuna campagna, quindi non compaiono nella scheda Unsubscribes di una campagna. Quando i destinatari si disiscrivono da soli con il link di una campagna, lasciano tutte le liste in una volta. Vedi Disiscrizioni.

Rimuovi un iscritto

Rimuovere un iscritto elimina l’appartenenza alla lista. Seleziona Delete nel menu della riga nella pagina della lista, Remove from audience nella pagina del contatto, oppure chiama Elimina un iscritto.

Quando qualcuno fa opt-out, preferisci la disiscrizione, così ne conservi traccia. Rimuovi gli iscritti aggiunti per errore o che non vuoi più tenere. Per eliminare del tutto la persona, elimina il contatto, che viene rimosso da tutte le liste.

Elenca e trova gli iscritti

Nella pagina della lista, cerca per email o nome e filtra per Email, First name, Last name, Subscribed o Created.

Con l’API, Elenca gli iscritti restituisce tutti gli iscritti, compresi quelli disiscritti. Aggiungi subscribed=true o subscribed=false per restringere l’elenco, search per cercare per email o nome, e page e limit (fino a 100) per scorrere le pagine:

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

Per cercare una persona, usa Recupera un iscritto con l’ID sub_ o l’indirizzo email.

Vedi anche