Log InSign Up
All Posts
List API hero

Introducing the Lists API: Notify Lists of Users With One API Call

Nate Munger

October 13, 2020

Companies today send user notifications across a growing number of platforms and channels. To help you send the right notification on the right channel at the right time, Courier lets you define your user preferences and store them on a recipient profile via our Profiles API

But there’s another challenge: many times there are groups of users you want to message with the same notification triggered by the same event. 

In the past, this meant tens or sometimes thousands of API calls triggering the same notification over and over. But now, with the release of Courier’s Lists API, you’re able to create lists, subscribe recipient profiles to them, and notify every user on the list with a single Send API call. 

Courier handles the message fanout – following user preferences and your channel priorities – to deliver across email, SMS, mobile push, messaging apps, and more.

1 2 3 4 5 curl --request POST \ --url \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '{"list":"webapp.new_feature.alpha_users","event":"alpha_access_granted"}'

With the Lists API, you can easily do things like: 

  • Reach every user in a shared workspace.  

  • Notify all users who follow a specific project.

  • Message users who opt in to select notifications. 

Wildcard Sends: Notify subscribed users, across multiple lists, with one API call

The Lists API accepts List IDs with up to four parts. Giving you plenty of flexibility to create lists for almost any use case.

  • part1

  • part1.part2

  • part1.part2.spart3

  • part1.part2.part3.part4

Following this basic pattern when defining List IDs will enable wildcard sending. This means you can send to multiple list parts within a related pattern using a single API call.  

1 2 3 4 5 curl --request POST \ --url \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '{"pattern":"webapp.new_feature.*","event":"new_feature_access_granted","brand":"W50NC77P524K14M5300PGPEK4JMJ","data":"{\"name\": \"Jane Doe\",\"age\": 27}"}'

When sending to a Pattern that matches multiple Lists, Courier will send only one notification to any user with multiple matching subscriptions.

Get started with the Lists API

For more details on how to create and send to lists, check out the Lists API reference doc. You can read more about how to name your lists and use wildcards in our Lists API help article.

Read more

Courier Live: First Look at Notifying Multiple Recipients using Lists

More from Courier


Common Courier Troubleshooting Solutions for Developers

In this post, we will discuss example issues around Courier’s Gmail integration and API rate limits, an incomplete data profile, and an incomplete request with Inbox and Toast, and how to fix them.

Rodrigo Rojas

Rodrigo Rojas

July 21, 2022


How We Became HIPAA Compliant

Today, we are excited to announce that Courier is now HIPAA compliant and this post will get into why SaaS companies should be HIPAA compliant, why this is important for our company, and the steps we took to get here.

Aman Kandola

Aman Kandola

July 20, 2022

Build your first notification in minutes

Send up to 10,000 notifications every month, for free.

Email & push notification

Build your first notification in minutes

Send up to 10,000 notifications every month, for free.

Email & push notification









© 2022 Courier. All rights reserved.