Docs 📖

Your webhooks can be found inside the app. The URLs you see in there already contain your secret. The examples below show monkeys 🙈 where your secret goes.

Send a simple push notification

The easiest way to send send a push notification by sending a POST request to a webhook with a plain text body that'll be displayed in the notification body.

curl -X POST https://dev.api.brrr.now/v1/🙈🙈🙈🙈🙈🙈🙈🙈🙈🙈 \\
  -d 'Hello world!'

Send JSON to customize

Send a JSON request body to customize the alert, for example, to include a title, a non-default sound, or an expiration date.

curl -X POST https://dev.api.brrr.now/v1/🙈🙈🙈🙈🙈🙈🙈🙈🙈🙈 \\
  -H 'Content-Type: application/json' \\
  -d '{
    "title": "Coffee Machine Offline",
    "body": "The coffee machine is currently unreachable. Morale is expected to drop.",
    "sound": "upbeat_json",
    "expiration_date": "2026-04-23T09:00:00.000Z"
  }'

The JSON request body may contain any of the following fields.

title

String. First line of the notification, if present.

subtitle

String. Line under the title, if present.

body

String. Primary content of the notification.

sound

String. Can be one of default, system.brrr.bubble_ding, bubbly_success_ding, calm2, short_triple_blink, upbeat_bellsm, and warn_soft_error.

open_url

String. Link to open when the notification is selected.

image_url

String. Link to an image to be displayed in the notification.

expiration_date

ISO 8601 date and time. In case the notification isn't successfully delivered when the webhook is invoked, Apple Push Notification Service may retry until the expiration date is reached.