Unsubscribe Sources

To see the source of a particular unsubscribe event for a user, you can retrieve the data from Iterable in two ways:

1. Export the data through our Export API endpoint (choose "emailUnsubscribe" in "dataTypeName"):

In the export, look for the field "unsubSource".

2. Look for the Unsubscribe event on the user's profile

To get to the user's profile, go to Users > User Lookup and type their full email address).

Look at the fields in their profile until you find the field called "unsubSource":

The field "unsubSource" will have one of the following values. Below is an explanation for each:

1. WebApp

When you remove a user from a list or a channel from the profile page on the UI. Also, if you go to a list and use the "unsubscribe from list" button to upload users to remove from the list or if you upload list to channel unsubscribe users.

2. API

If the unsubscribe occurs from one of our API endpoints:

Lists Unsubscribe: http://api.iterable.com/api/docs#!/lists/unsubscribe_post_1

Update Subscriptions: https://api.iterable.com/api/docs#!/users/updateSubscriptions_post_5

3. HardBounce

When an email is considered undeliverable and hard bounces.

4. Complaint

If a user marks your email as Spam, Iterable automatically unsubscribes them from the corresponding channel.

5. Workflow

If a user goes through an "Unsubscribe" Action Node in Iterable.

6. SMS

If a user unsubscribes via SMS by replying with one of the following words: 

"stop", "stopall", "unsubscribe", "end", "cancel", "quit".

7. ISP

This type occurs when the ISP sends Iterable an unsubscribe email. This happens when Iterable sets special unsubscribe headers on the email, and the user can click a unsubscribe button that shows up at the top of the email if their inbox shows it.

8. ESP

If the ESP puts the user on a suppression list.

9. EmailLink

If the unsubscribe came from {{unsubscribeUrl}} and {{unsubscribeMessageTypeUrl}} in the Iterable template. It can also happen if you use {{hostedUnsubscribeUrl}}, but it fails to build the url, and redirects to our unsubscribe page instead.