Integrate brrr with cURL

If you can run curl, you can send a push with brrr. Grab one of your webhook URLs from the app and send a POST request to it.

The examples below use 🙈🙈🙈🙈🙈🙈🙈🙈🙈🙈 as a placeholder for your secret. Replace it with the secret already included in your webhook URL from the app.

Send a simple push

The fastest path is a plain text request body. Whatever you send becomes the notification message.

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

This is useful for shell scripts, local automation, and one-off checks while you are testing a workflow.

You can also send notifications with simple HTTP GET requests. This is handy for quick testing and clients with limited HTTP support.

GET supports the same parameters as POST, passed as query parameters instead of in the request body.

curl 'https://api.brrr.now/v1/🙈🙈🙈🙈🙈🙈🙈🙈🙈🙈?message=Hello%20world!%20%F0%9F%9A%80&title=Quick%20test'

Send JSON to customize the notification

Use JSON when you want a title, a custom sound, or more control over how the notification is delivered.

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

If you want the full list of supported fields, continue to Docs or jump directly to Send test notification to build a payload interactively.