Iscritti

Aggiungi, aggiorna e rimuovi gli iscritti di una lista.

URL di basehttps://api.emailit.com/v2Autenticazione Errori Limiti di frequenza

POST/audiences/{audience_id}/subscribers
GET/audiences/{audience_id}/subscribers/{id}
POST/audiences/{audience_id}/subscribers/{id}
GET/audiences/{audience_id}/subscribers
POST/audiences/{audience_id}/subscribers/bulk
DEL/audiences/{audience_id}/subscribers/{id}

Aggiungi un iscritto

Aggiunge un contatto a una lista tramite l’indirizzo email.

POST/audiences/{audience_id}/subscribers

Richiede una chiave API full. Se nessun contatto ha ancora questo indirizzo email, Emailit ne crea uno. Se il contatto esiste, i nomi e i campi personalizzati che invii sovrascrivono i valori attuali. Un contatto che si era disiscritto dalla lista viene iscritto di nuovo e la risposta è 200; per un contatto già iscritto la risposta è 409.

Ogni lista può contenere tanti iscritti quanti ne consente il piano; oltre questo limite, la richiesta restituisce 422 con il tuo usage. Genera subscriber.created, oppure subscriber.updated e subscriber.resubscribed in caso di reiscrizione.

Con double_opt_in, la persona riceve l’email di double opt-in della lista ed entra nella lista quando fa clic sul link, quindi la risposta è 202 e l’iscritto non esiste ancora.

Parametri di percorso

audience_idstringobbligatorio

L’ID della lista (aud_…) o il suo nome.

Parametri del corpo

emailstringobbligatorio

L’indirizzo email da iscrivere. Viene salvato in minuscolo.

first_namestring

Il nome del contatto.

last_namestring

Il cognome del contatto.

custom_fieldsobject

I valori dei campi personalizzati per chiave, ad esempio {"company": "Analytical Engines"}. Sostituisce i campi personalizzati esistenti del contatto.

double_opt_inbooleanpredefinito: false

Invia l’email di double opt-in invece di iscrivere subito la persona. La lista deve avere il double opt-in attivo, altrimenti la richiesta restituisce 422. Una persona già iscritta riceve 409 come di consueto.

send_confirmation_emailbooleanpredefinito: false

Invia l’email di conferma della lista dopo l’iscrizione, se è attiva.

Restituisce

Restituisce 201 con l’oggetto iscritto, oppure 200 quando un contatto disiscritto è stato iscritto di nuovo. Con double_opt_in, restituisce 202 con object: "subscriber_confirmation", status: "pending", audience_id, contact_id ed email. Se non è possibile inviare l’email di double opt-in, la richiesta restituisce 422 con un code come unverified_domain o insufficient_credits.

POST/audiences/{audience_id}/subscribers

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const subscriber = await emailit.subscribers.create('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', {
  email: 'ada@example.com',
  first_name: 'Ada',
  last_name: 'Lovelace',
});

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

subscriber = client.subscribers.create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", {
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
})

PHP

$emailit = Emailit::client('your_api_key');

$subscriber = $emailit->subscribers()->create('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', [
  'email' => 'ada@example.com',
  'first_name' => 'Ada',
  'last_name' => 'Lovelace',
]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

subscriber = client.subscribers.create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  email: "ada@example.com",
  first_name: "Ada",
  last_name: "Lovelace"
)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

subscriber, err := client.Subscribers.Create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", &emailit.CreateSubscriberRequest{
  Email:     "ada@example.com",
  FirstName: "Ada",
  LastName:  "Lovelace",
})

Rust

use emailit::Emailit;
use emailit::types::CreateSubscriberParams;

let emailit = Emailit::new("your_api_key");

let subscriber = emailit.subscribers.create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  CreateSubscriberParams::new("ada@example.com")
    .with_first_name("Ada")
    .with_last_name("Lovelace")
).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject subscriber = emailit.subscribers().create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  SubscriberCreateParams.builder()
    .setEmail("ada@example.com")
    .setFirstName("Ada")
    .setLastName("Lovelace")
    .build()
);

using Emailit;

var emailit = new EmailitClient("your_api_key");

var subscriber = emailit.Subscribers.Create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", new SubscriberCreateOptions {
  Email = "ada@example.com",
  FirstName = "Ada",
  LastName = "Lovelace",
});

PHP

use Emailit\Laravel\Facades\Emailit;

$subscriber = Emailit::subscribers()->create('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', [
  'email' => 'ada@example.com',
  'first_name' => 'Ada',
  'last_name' => 'Lovelace',
]);

Terminal

curl -X POST https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers \
  -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": "Analytical Engines" }
  }'

JSON

{
  "object": "subscriber",
  "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines"
  },
  "subscribed": true,
  "subscribed_at": "2026-10-01T10:20:31.000000Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-01T10:20:31.000000Z"
}

JSON

{
  "object": "subscriber_confirmation",
  "status": "pending",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "message": "A double opt-in email was sent. They join the audience when they click its link."
}

JSON

{
  "error": "Audience not found"
}

JSON

{
  "error": "Contact is already subscribed to this audience",
  "existing": {
    "object": "subscriber",
    "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
    "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
    "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Analytical Engines" },
    "subscribed": true,
    "subscribed_at": "2026-10-01T10:20:31.000Z",
    "unsubscribed_at": null,
    "created_at": "2026-10-01T10:20:31.000Z",
    "updated_at": "2026-10-01T10:20:31.000Z"
  }
}

JSON

{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": {
    "used": 50000,
    "limit": 50000,
    "plan": "pro"
  }
}

Recupera un iscritto

Recupera l’appartenenza di un contatto a una lista.

GET/audiences/{audience_id}/subscribers/{id}

Richiede una chiave API full. Un iscritto collega un contatto a una lista. L’email, i nomi e i campi personalizzati appartengono al contatto, mentre subscribed riguarda solo questa lista.

Parametri di percorso

audience_idstringobbligatorio

L’ID della lista (aud_…) o il suo nome.

idstringobbligatorio

L’ID dell’iscritto (sub_…) o l’indirizzo email del contatto, codificato per l’URL.

Restituisce

Restituisce l’oggetto iscritto.

objectstring

Sempre subscriber.

idstring

L’ID dell’iscritto.

audience_idstring

L’ID della lista.

contact_idstring

L’ID del contatto.

emailstring

L’indirizzo email del contatto.

first_namestring | null

Il nome del contatto.

last_namestring | null

Il cognome del contatto.

custom_fieldsobject | null

I valori dei campi personalizzati del contatto.

subscribedboolean

true se il contatto è iscritto a questa lista, false se si è disiscritto.

subscribed_atstring | null

Quando il contatto si è iscritto l’ultima volta.

unsubscribed_atstring | null

Quando il contatto si è disiscritto, oppure null.

created_atstring

Quando il contatto è entrato nella lista.

updated_atstring

Quando è cambiata l’ultima volta l’appartenenza alla lista.

GET/audiences/{audience_id}/subscribers/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const subscriber = await emailit.subscribers.get('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

subscriber = client.subscribers.get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")

PHP

$emailit = Emailit::client('your_api_key');

$subscriber = $emailit->subscribers()->get('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

subscriber = client.subscribers.get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

subscriber, err := client.Subscribers.Get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let subscriber = emailit.subscribers.get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo").await?;

Java

import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject subscriber = emailit.subscribers().get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var subscriber = emailit.Subscribers.Get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo");

PHP

use Emailit\Laravel\Facades\Emailit;

$subscriber = Emailit::subscribers()->get('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');

Terminal

curl https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/sub_4KECYl5AwXEy8ezswYRhuddttxo \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "subscriber",
  "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines"
  },
  "subscribed": true,
  "subscribed_at": "2026-10-01T10:20:31.000000Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-01T10:20:31.000000Z"
}

JSON

{
  "error": "Subscriber not found"
}

Aggiorna un iscritto

Modifica lo stato di un iscritto nella lista, oppure i dati del suo contatto.

POST/audiences/{audience_id}/subscribers/{id}

Richiede una chiave API full. Invia solo i campi che vuoi modificare. subscribed vale solo per questa lista. email, first_name, last_name e custom_fields modificano il contatto stesso, quindi la modifica compare in ogni lista a cui il contatto appartiene. Genera un evento subscriber.updated.

Parametri di percorso

audience_idstringobbligatorio

L’ID della lista (aud_…) o il suo nome.

idstringobbligatorio

L’ID dell’iscritto (sub_…) o l’indirizzo email del contatto, codificato per l’URL.

Parametri del corpo

subscribedboolean

false per disiscrivere il contatto da questa lista, true per iscriverlo di nuovo. In entrambi i casi l’iscritto resta nella lista.

emailstring

Un nuovo indirizzo email per il contatto. Viene salvato in minuscolo.

first_namestring

Il nome del contatto.

last_namestring

Il cognome del contatto.

custom_fieldsobject

Valori dei campi personalizzati per chiave. Sostituiscono i campi personalizzati esistenti del contatto.

Restituisce

Restituisce l’oggetto iscritto aggiornato. Una richiesta senza nessuno di questi campi restituisce 400.

POST/audiences/{audience_id}/subscribers/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const subscriber = await emailit.subscribers.update('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo', {
  first_name: 'Augusta',
});

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

subscriber = client.subscribers.update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo", {
  "first_name": "Augusta",
})

PHP

$emailit = Emailit::client('your_api_key');

$subscriber = $emailit->subscribers()->update('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo', [
  'first_name' => 'Augusta',
]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

subscriber = client.subscribers.update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  first_name: "Augusta"
)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

subscriber, err := client.Subscribers.Update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo", &emailit.UpdateSubscriberRequest{
  FirstName: "Augusta",
})

Rust

use emailit::Emailit;
use emailit::types::UpdateSubscriberParams;

let emailit = Emailit::new("your_api_key");

let subscriber = emailit.subscribers.update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo", UpdateSubscriberParams {
  first_name: Some("Augusta".into()),
  ..Default::default()
}).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject subscriber = emailit.subscribers().update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  SubscriberUpdateParams.builder()
    .setFirstName("Augusta")
    .build()
);

using Emailit;

var emailit = new EmailitClient("your_api_key");

var subscriber = emailit.Subscribers.Update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo", new SubscriberUpdateOptions {
  FirstName = "Augusta",
});

PHP

use Emailit\Laravel\Facades\Emailit;

$subscriber = Emailit::subscribers()->update('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo', [
  'first_name' => 'Augusta',
]);

Terminal

curl -X POST https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/sub_4KECYl5AwXEy8ezswYRhuddttxo \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Augusta"}'

Terminal

curl -X POST https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/ada%40example.com \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subscribed": false}'

JSON

{
  "object": "subscriber",
  "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines"
  },
  "subscribed": false,
  "subscribed_at": "2026-10-01T10:20:31.000000Z",
  "unsubscribed_at": "2026-10-02T08:14:55.000000Z",
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-02T08:14:55.000000Z"
}

JSON

{
  "error": "No valid fields provided for update. Provide at least one of: email, first_name, last_name, custom_fields, subscribed"
}

JSON

{
  "error": "Subscriber not found"
}

Elenca gli iscritti

Restituisce una pagina degli iscritti di una lista, a partire dal più recente.

GET/audiences/{audience_id}/subscribers

Richiede una chiave API full. L’elenco include i contatti che si sono disiscritti dalla lista, a meno che non li escludi con subscribed=true.

Parametri di percorso

audience_idstringobbligatorio

L’ID della lista (aud_…) o il suo nome.

Parametri di query

pageintegerpredefinito: 1

La pagina da restituire.

limitintegerpredefinito: 25

Iscritti per pagina, da 1 a 100. Funziona anche per_page.

subscribedstring

true per i soli contatti iscritti, false per i soli disiscritti.

engagementstring

unengaged per gli iscritti che risultano inattivi nel periodo della lista, engaged per gli altri. Combinalo con subscribed=true per escludere le persone che si sono già disiscritte.

searchstring

Corrispondenza sull’indirizzo email, sul nome o sul cognome, senza distinzione tra maiuscole e minuscole.

matchstringpredefinito: all

all o or. Come si combinano i filtri qui sotto.

orderstring

Una chiave di filtro per cui ordinare.

directionstring

asc o desc.

Filtri

Aggiungi i filtri nella forma key.condition=value, ad esempio email.ends_with=@acme.com. Vedi Filtri e ordinamento.

Chiave	Tipo	Note
`email`	string
`first_name`	string
`last_name`	string
`subscribed`	boolean
`subscribed_at`	date	Quando è iniziata l’ultima iscrizione.
`last_engaged_at`	date	L’ultima apertura o l’ultimo clic del contatto. I valori vuoti vengono ordinati per ultimi.
`created_at`	date	Quando il contatto è entrato nella lista.

Ogni chiave è anche una chiave di ordinamento.

Restituisce

dataobject[]

Gli oggetti iscritto di questa pagina. Negli elenchi ognuno ha anche last_opened_at, last_clicked_at e last_engaged_at (l’ultima apertura del contatto, l’ultimo clic e il più recente dei due, oppure null) e unengaged.

total_recordsinteger

Il numero di iscritti che corrispondono.

next_page_urlstring | null

Percorso della pagina successiva, oppure null. Mantiene subscribed ed engagement ma non gli altri filtri. Vedi Paginazione.

previous_page_urlstring | null

Percorso della pagina precedente, oppure null.

usageobject

used (iscritti nella lista), limit (il massimo consentito dal piano per ogni lista, oppure null) e plan.

GET/audiences/{audience_id}/subscribers

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const subscribers = await emailit.subscribers.list('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

subscribers = client.subscribers.list("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2")

PHP

$emailit = Emailit::client('your_api_key');

$subscribers = $emailit->subscribers()->list('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

subscribers = client.subscribers.list("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

subscribers, err := client.Subscribers.List("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", nil)

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let subscribers = emailit.subscribers.list("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", None).await?;

Java

import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject subscribers = emailit.subscribers().list("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var subscribers = emailit.Subscribers.List("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2");

PHP

use Emailit\Laravel\Facades\Emailit;

$subscribers = Emailit::subscribers()->list('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2');

Terminal

curl https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Terminal

curl -G https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d subscribed=true \
  -d limit=100

JSON

{
  "data": [
    {
      "object": "subscriber",
      "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
      "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      },
      "subscribed": true,
      "subscribed_at": "2026-10-01T10:20:31.000000Z",
      "unsubscribed_at": null,
      "last_opened_at": "2026-10-06T08:14:02.000000Z",
      "last_clicked_at": null,
      "last_engaged_at": "2026-10-06T08:14:02.000000Z",
      "unengaged": false,
      "created_at": "2026-10-01T10:20:31.000000Z",
      "updated_at": "2026-10-01T10:20:31.000000Z"
    },
    {
      "object": "subscriber",
      "id": "sub_4KnmYprkoMRytdkm3tAHIfPW0Vh",
      "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "contact_id": "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7",
      "email": "grace@example.com",
      "first_name": "Grace",
      "last_name": "Hopper",
      "custom_fields": null,
      "subscribed": false,
      "subscribed_at": "2026-09-28T07:55:02.000000Z",
      "unsubscribed_at": "2026-09-30T18:11:40.000000Z",
      "last_opened_at": null,
      "last_clicked_at": null,
      "last_engaged_at": null,
      "unengaged": false,
      "created_at": "2026-09-28T07:55:02.000000Z",
      "updated_at": "2026-09-30T18:11:40.000000Z"
    }
  ],
  "total_records": 2,
  "next_page_url": null,
  "previous_page_url": null,
  "usage": {
    "used": 2,
    "limit": 50000,
    "plan": "pro"
  }
}

JSON

{
  "error": "Audience not found"
}

Aggiorna gli iscritti in blocco

Iscrive, disiscrive o rimuove molti iscritti di una lista.

POST/audiences/{audience_id}/subscribers/bulk

Richiede una chiave API full. Scegli gli iscritti con ids, oppure imposta all_matching per agire su tutte le persone che corrispondono ai filtri, fino a 10.000. Ogni modifica genera lo stesso evento della modifica di un singolo iscritto: subscriber.updated per l’iscrizione e la disiscrizione, subscriber.deleted per l’eliminazione. La disiscrizione lascia le persone nella lista con subscribed: false; l’eliminazione rimuove la loro appartenenza alla lista e mantiene i contatti. Vedi Azioni di massa.

Parametri di percorso

audience_idstringobbligatorio

L’ID della lista (aud_…) o il suo nome.

Parametri del corpo

actionstringobbligatorio

subscribe, unsubscribe o delete.

idsstring[]

Gli ID degli iscritti (sub_…), fino a 1000. Devono appartenere tutti alla lista, altrimenti non cambia nulla e la richiesta restituisce 404 con gli ID in missing.

all_matchingbooleanpredefinito: false

Agisce su tutti gli iscritti che corrispondono ai filtri qui sotto invece che su ids. Con più di 10.000 corrispondenze la richiesta restituisce 422.

engagementstring

Con all_matching: unengaged o engaged. Vedi Contatti inattivi.

subscribedboolean

Con all_matching: solo le persone iscritte (true) o disiscritte (false).

searchstring

Con all_matching: corrispondenza sull’indirizzo email, sul nome o sul cognome, senza distinzione tra maiuscole e minuscole.

Restituisce

objectstring

Sempre subscriber_bulk.

actionstring

L’azione che hai inviato.

audience_idstring

L’ID della lista.

processedinteger

Quanti iscritti sono stati selezionati.

changedinteger

Quanti sono stati modificati. Iscrivere qualcuno che è già iscritto non conta.

POST/audiences/{audience_id}/subscribers/bulk

JavaScript

const response = await fetch('https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/bulk', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    action: 'unsubscribe',
    all_matching: true,
    engagement: 'unengaged',
    subscribed: true
  })
});

const { changed } = await response.json();

Terminal

curl -X POST https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/bulk \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "unsubscribe", "all_matching": true, "engagement": "unengaged", "subscribed": true}'

JSON

{
  "object": "subscriber_bulk",
  "action": "unsubscribe",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "processed": 212,
  "changed": 212
}

JSON

{
  "error": "One or more subscribers were not found",
  "missing": ["sub_4KnmYprkoMRytdkm3tAHIfPW0Vh"]
}

JSON

{
  "error": "More than 10000 subscribers match. Narrow the filter and try again."
}

Elimina un iscritto

Rimuove un contatto da una lista.

DELETE/audiences/{audience_id}/subscribers/{id}

Richiede una chiave API full. Il contatto in sé non viene eliminato e resta nelle sue altre liste. Per conservare traccia del fatto che qualcuno ha scelto l’opt-out, disiscrivilo invece con subscribed: false. Genera un evento subscriber.deleted.

Parametri di percorso

audience_idstringobbligatorio

L’ID della lista (aud_…) o il suo nome.

idstringobbligatorio

L’ID dell’iscritto (sub_…) o l’indirizzo email del contatto, codificato per l’URL.

Restituisce

objectstring

Sempre subscriber.

idstring

L’ID dell’iscritto eliminato.

audience_idstring

L’ID della lista.

contact_idstring

L’ID del contatto.

emailstring

L’indirizzo email del contatto.

deletedboolean

Sempre true.

DELETE/audiences/{audience_id}/subscribers/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

await emailit.subscribers.delete('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

client.subscribers.delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")

PHP

$emailit = Emailit::client('your_api_key');

$emailit->subscribers()->delete('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

client.subscribers.delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

err := client.Subscribers.Delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

emailit.subscribers.delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo").await?;

Java

import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

emailit.subscribers().delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo");

using Emailit;

var emailit = new EmailitClient("your_api_key");

emailit.Subscribers.Delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo");

PHP

use Emailit\Laravel\Facades\Emailit;

Emailit::subscribers()->delete('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');

Terminal

curl -X DELETE https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/sub_4KECYl5AwXEy8ezswYRhuddttxo \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "subscriber",
  "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "deleted": true
}

JSON

{
  "error": "Subscriber not found"
}