Smart Notification Scheduling with Delivery Windows

Smart Notification Scheduling with Delivery Windows

Sending a notification is simple—sending it at the right time is not. Whether it’s avoiding off-hours pings or managing users across time zones, timing matters. With Courier’s new Delivery Window, you can deliver messages at the perfect moment—without the overhead of custom scheduling code.

Set the Rules, We’ll Handle the Rest
The Delivery Window feature lets you define when notifications should go out, and Courier ensures they follow your rules. Instead of instant delivery, send the notification when it’s best for your user to get it and act on it.

For example, if a non-urgent alert is triggered on Sunday at 3 PM, you can configure a delivery window for work hours: Monday to Friday, 10 AM to 4 PM. Courier will hold the message and deliver it Monday at 10 AM—seamlessly, no extra work required.

Some key features include:

• Time zone adaptability, allowing messages to be sent based on specific user locations
• Support for both IANA and UTC± formats
• Flexible scheduling with the ability to define complex windows

Here’s what it looks like in your API request:

1
// If sent Thursday at noon, will send immediately
2
// If sent Saturday at noon, will delay until 8am the following Monday
3
{
4
  "message": {
5
    "to": {
6
      "user_id": "test123",
7
      "timezone": "Americas/Los_Angeles"
8
    },
9
    "delay": {
10
      "until": "Mo-Fr 08:00-16:30"
11
    }
12
  }
13
}

Get Started Today
Ready to see it in action? Explore the Delivery Window docs and start sending notifications at the right time for users.