List is a group of subscribers or recipients to whom bulk messages can be sent. e.g., you can create a list of users who signed up in the last 30 days. You can now manage subscriber lists in SuprSend and send campaigns or broadcasts to pre-created lists of users without the need to add each user individually when making the API call.

By default, SuprSend creates a list named all_users, which automatically includes all users available in your workspace. You can use this list to send campaigns like newsletters and product updates.

​
Creating Lists

You can create lists using one of the following methods:

​
Configure list events

You can configure events when a user enters or exits a list. e.g. - you have a list of users “Active on the platform in last 7 days”. Whenever a user exists this list, you might want to send a notification to re-engage the users. You can do so using list events. There are 2 types of list events that you can configure

  • User Entry - This will trigger a bulk event $USER_ENTERED_LIST - <list_id> for all new users added to the list whenever a list is updated.
  • User Exit - This will trigger a bulk event $USER_EXITED_LIST - <list_id> for all new users removed from the list whenever a list is updated.

List events is a list property and can be updated using Modify List option on SuprSend dashboard -> List page or using the list API. Event tracking is set as false by default.

​
Sending notification to list users

  • You can either setup individual workflows for list users based on list events. e.g., if you want to notify job seekers who were active on the platform in the last 7 days but left today.
  • The most recommended way to send notification to list users is via Broadcast. You can schedule broadcast on this list from the dashboard by clicking on “Run Broadcast” option or trigger it programmatically via API.We recommend sending broadcasts using promotional category so you don’t end up overloading transactional and system queues. Learn more about how to choose the right notification category here.

Avoid using individual workflows on a consecutive list update of more than 1000 users. It can add a delay in your notification queue.