Skip to main content


The send API lets you send a message to one or more recipients with a single call. Messages are sent asynchronously, so when you call the send API, the response will contain a request ID that you can use to check the status of your message later.

Recipients come in several forms:

  • User - A single user
  • List (by ID) - A pre-defined list of users stored with Courier
  • List pattern - A pattern that can target multiple lists of users at once
  • Audience - A Courier audience containing users.

You may also pass an array containing any combination of the above.

There are two styles of notification sending:

  • by template
  • ad-hoc

To send by template, first create a notification using Courier Studio, then pass the template ID in your send call. To send ad-hoc, include the content of the notification directly in the send call using Elemental.

Was this helpful?