Skip to content
Docs

How-to

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.

Updated Oct 9, 2026

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

  1. Open the audience. Go to Email MarketingAudiences and select the audience.

  2. Add the person. Select Add subscriber, enter the Email, and optionally First name and Last name.

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

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:

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

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

Let people add themselves from your site.
The person behind every subscriber.

Was this page helpful?

Thanks for the feedback.

Thanks, we read every message.