How-to
Manage subscribers
Add and import people to an audience, edit them, turn their Subscribed flag on or off, remove them, and do it in bulk, in the dashboard or with the Subscribers API.
A subscriber is one contact’s membership in one audience. This page shows how to add subscribers, change them, unsubscribe or resubscribe them, and remove them, and what each change does to the contact behind them.
Before you begin
- Create the audience first. See Audiences.
- Check how much room the audience has. The limit counts every subscriber, including unsubscribed ones. See Limits.
- For the API, use an API key with Full Access.
Add a subscriber
-
Open the audience. Go to Email MarketingAudiences and select the audience.
-
Add the person. Select Add subscriber, enter the Email, and optionally First name and Last name.
-
Save. Select Add. If no contact exists for the address, Emailit creates one.
When the audience has double opt-in on, Ask them to confirm by email first (double opt-in) is checked: the person gets the double opt-in email and joins when they click its link. Clear it to add them right away. When the audience has a confirmation email, Send the confirmation email sends it to the person you add.
You can also add existing contacts from Email MarketingContacts: open a contact and select Add to audience, or select several contacts and use Actions > Add to audience. To add many people at once, import a file.
Call Add a subscriber with the audience’s ID or name:
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"
}Only email is required. If you pass first_name, last_name or custom_fields for an existing contact, they overwrite the contact’s values, and custom_fields replaces the whole object.
Pass "double_opt_in": true to send the audience’s double opt-in email instead of adding the person right away; the response is 202 with "status": "pending". Pass "send_confirmation_email": true to send the audience’s confirmation email after adding them.
When the person is already on the audience
Adding an address that’s already on the audience depends on its current state:
| Current state | Result | API response |
|---|---|---|
| Not on the audience | A new subscriber is created with Subscribed on. | 201 |
| On the audience, Subscribed on | Nothing changes. The dashboard shows “Contact is already subscribed to this audience”. | 409 with the subscriber in existing |
| On the audience, unsubscribed | The subscriber is resubscribed: Subscribed turns on, subscribed_at is set to now and unsubscribed_at is cleared. |
200 |
| The audience is full | Nothing is added. | 422 with usage |
A resubscribe through this endpoint sends subscriber.updated and subscriber.resubscribed events and starts Added to audience automations, the same as a new subscriber.
Import subscribers
To add many people at once, open the audience and select Import. Upload a CSV or Excel file with up to 2,500 rows, map its columns to contact fields, check the preview and select Import. Everyone in the file is added to this audience; contacts that don’t exist yet are created.
Imports run in the background, so new subscribers show up after a moment. They don’t ask for double opt-in, don’t send the confirmation email and don’t send subscriber events. To import into several audiences at once, use the import on the Contacts list. See Import and export contacts.
Edit a subscriber
In the audience’s subscribers table, open the row menu and select Edit. You can change First name, Last name and the Subscribed switch. The email address is read-only here.
With the API, call Update a subscriber. Identify the subscriber by its sub_ ID or by email address, and send any of email, first_name, last_name, custom_fields and 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 }'Names, email and custom fields belong to the contact, not the subscriber. Changing them here updates the contact everywhere, including in its other audiences. Only subscribed is specific to this audience.
Turn Subscribed on or off
The Subscribed flag decides whether campaigns to this audience reach the person. Turning it off keeps the subscriber on the list, records unsubscribed_at and leaves the contact’s other audiences alone. Turning it back on sets a new subscribed_at and clears unsubscribed_at.
| Where | Unsubscribe | Resubscribe |
|---|---|---|
| Audience page | Edit, then turn off Subscribed | Edit, then turn on Subscribed |
| Contact page | Unsubscribe in the audience’s row menu | Resubscribe in the row menu |
| API | Update a subscriber with "subscribed": false |
Update with "subscribed": true, or add the address again |
These changes send a subscriber.updated event. They don’t record an unsubscribe on any campaign, so they don’t appear in a campaign’s Unsubscribes tab. When recipients unsubscribe themselves with the link in a campaign, they leave every audience at once. See Unsubscribes.
Remove a subscriber
Removing a subscriber deletes the membership. Select Delete in the row menu on the audience page, Remove from audience on the contact page, or call Delete a subscriber.
| Unsubscribe | Remove | |
|---|---|---|
| Person stays on the list | Yes, with Subscribed off | No |
| Counts toward the audience limit | Yes | No |
| Contact is kept | Yes | Yes |
| Event | subscriber.updated |
subscriber.deleted, which starts Removed from audience automations |
| Adding the address again | Resubscribes the existing subscriber | Creates a new subscriber |
Prefer unsubscribing when someone opts out, so you keep a record of it. Remove subscribers you added by mistake or no longer want to keep. To delete the person entirely, delete the contact, which removes it from every audience.
Bulk actions
Select subscribers with the checkboxes, then use Actions:
- Subscribe turns Subscribed on.
- Unsubscribe turns Subscribed off and keeps them on the list.
- Remove from audience deletes their memberships. The contacts stay.
To act on more than one page, select the whole page with the header checkbox and then Select all matching subscribers. That selects everyone matching the current view (All, Engaged or Unengaged) and search, up to 10,000 people. Each change sends the same events as changing the subscriber by hand.
With the API, call Bulk update subscribers with up to 1,000 subscriber IDs, or with "all_matching": true and an optional engagement or subscribed filter.
List and find subscribers
On the audience page, search by email or name, and filter by Email, First name, Last name, Subscribed, Subscribed at, Last opened or clicked, or Added. Select a column header to sort by it. Last opened or clicked shows the contact’s latest open or click of any email from your workspace, and the Engaged and Unengaged views split the subscribed people by the audience’s unengaged rule.
With the API, List subscribers returns every subscriber, including unsubscribed ones. Add subscribed=true or subscribed=false to narrow the list, engagement=engaged or engagement=unengaged to split by engagement, search to match email or names, order and direction to sort, and page and limit (up to 100) to page through:
curl "https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers?subscribed=true&limit=100&page=1" \
-H "Authorization: Bearer $EMAILIT_API_KEY"To look up one person, Retrieve a subscriber by sub_ ID or email address.