# Gestisci gli iscritti

> Aggiungi persone a una lista, modificale, attiva o disattiva il loro indicatore Subscribed e rimuovile, dal pannello o con l’API degli 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](/it/docs/audiences/).
- Controlla quanto spazio ha la lista. Il limite conta tutti gli iscritti, compresi quelli disiscritti. Vedi [Limiti](/it/docs/audiences/#limits).
- Per l’API, usa una chiave API con **Full Access**.

## Aggiungi un iscritto

**Pannello**

  1. **Apri la lista.** Vai a **Email Marketing → Audiences** e seleziona la lista.

  2. **Aggiungi la persona.** Seleziona **Add subscriber**, compila il campo **Email** e, se vuoi, **First name** e **Last name**.

  3. **Salva.** Seleziona **Add**. Se per l’indirizzo non esiste un contatto, Emailit lo crea.

  Puoi anche aggiungere contatti esistenti da **Email Marketing → Contacts**: apri un contatto e seleziona **Add to audience**, oppure seleziona più contatti e usa **Actions > Add to audience**. Per aggiungere molte persone in una volta, [importa un file](/it/docs/contacts/import-export/).

**API**

  Chiama [Aggiungi un iscritto](/it/docs/api-reference/audiences/subscribers/add/) con l’ID o il nome della 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"
}
```

  Solo `email` è obbligatorio. Se passi `first_name`, `last_name` o `custom_fields` per un contatto esistente, sovrascrivono i valori del contatto, e `custom_fields` sostituisce l’intero oggetto.

### Quando la persona è già nella lista

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

| Stato attuale | Risultato | Risposta API |
| --- | --- | --- |
| Non è nella lista | Viene creato un nuovo iscritto con **Subscribed** attivo. | `201` |
| Nella lista, **Subscribed** attivo | Non cambia nulla. Il pannello mostra «Contact is already subscribed to this audience». | `409` con l’iscritto in `existing` |
| Nella lista, disiscritto | L’iscritto viene reiscritto: **Subscribed** si attiva, `subscribed_at` viene impostato sull’ora attuale e `unsubscribed_at` viene svuotato. | `200` |
| La lista è piena | Non viene aggiunto nulla. | `422` con `usage` |

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.

> **Attenzione:** Aggiungere di nuovo qualcuno che si è disiscritto lo reiscrive. Fallo solo quando la persona ha chiesto di tornare, ad esempio iscrivendosi sul tuo sito.

## 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](/it/docs/api-reference/audiences/subscribers/update/). 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`:

```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, 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`.

| Dove | Disiscrivere | Reiscrivere |
| --- | --- | --- |
| Pagina della lista | **Edit**, poi disattiva **Subscribed** | **Edit**, poi attiva **Subscribed** |
| Pagina del contatto | **Unsubscribe** nel menu della riga della lista | **Resubscribe** nel menu della riga |
| API | [Aggiorna un iscritto](/it/docs/api-reference/audiences/subscribers/update/) con `"subscribed": false` | Aggiorna con `"subscribed": true`, oppure [aggiungi](/it/docs/api-reference/audiences/subscribers/add/) di nuovo l’indirizzo |

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](/it/docs/audiences/unsubscribes/).

## 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](/it/docs/api-reference/audiences/subscribers/delete/).

| | Disiscrivere | Rimuovere |
| --- | --- | --- |
| La persona resta nella lista | Sì, con **Subscribed** disattivato | No |
| Conta per il limite della lista | Sì | No |
| Il contatto viene mantenuto | Sì | Sì |
| Evento | `subscriber.updated` | `subscriber.deleted`, che avvia le automazioni **Removed from audience** |
| Aggiungere di nuovo l’indirizzo | Reiscrive l’iscritto esistente | Crea un nuovo 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](/it/docs/api-reference/audiences/subscribers/list/) 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:

```bash
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](/it/docs/api-reference/audiences/subscribers/get/) con l’ID `sub_` o l’indirizzo email.

## Vedi anche

  - [URL di iscrizione](/it/docs/audiences/subscribe-url/): Permetti alle persone di iscriversi dal tuo sito.
  - [Contatti](/it/docs/contacts/): La persona dietro ogni iscritto.

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