Programmatically send notifications.
This end-point permits you to send push notifications programmatically.
Send push notifications to multiple targets. Only one of the target*
parameters is allowed at a time. Multiple values are separated by commas. Only 10,000 values are allowed per call. You can further restrict the target audience by using one of the filter*
parameters, which are applied in conjunction.
If you give no target but give a campaign, the campaign will be triggered.
NOTE: The below test tool will not work because readme.com will send all the target fields even if left empty. We're are waiting for their support to improve on this.
You can use the locale
field of the notification objects to make sure only subscribers from matching locales will see that notification. You can also give multiple notification objects using the notifications
argument, each with a different locale
value to enable localization of your notifications. Make sure to include a notification without a locale
to be used as a fallback, if you do not want to exclude subscribers that do not match any localized variants.
Providing multiple notification objects using the notifications
also enables A/B testing. If multiple variants are eligible for a given subscriber after considering their locale, one of the variants will be selected uniformly at random.
Please read our examples listed in the Sending notifications guide.