Browse docs +

Bring notifications into your workflow

Breeze sends a notification to your phone with one HTTP request. Copy your push link from the app and deliver the results of scripts, tasks, and automations to your iPhone or Android device.

Send a test notification · Choose an integration guide

BreezePreview
Backup complete

Your latest backup is complete.

One message, right when it matters.

Install Breeze, allow notifications, and copy the link on the Home tab. The last part of the link is your key. Anyone who has it can send notifications to your device, so keep it private.

text
https://push.breezelabs.dev/v1/YOUR_KEY

Send your first notification#

Open the link with a message in the path, or post plain text to it. Both work from a browser, a terminal, or any tool that can make an HTTP request.

cURL / Bash
curl https://push.breezelabs.dev/YOUR_KEY/Your%20backup%20is%20complete
cURL / Bash
curl https://push.breezelabs.dev/v1/YOUR_KEY \
  -H 'Content-Type: text/plain; charset=utf-8' \
  --data-binary 'Your backup is complete.'

Add a title, group, or link with JSON:

cURL / Bash
curl https://push.breezelabs.dev/v1/send \
  -H 'Authorization: Bearer YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Backup complete","body":"Your new backup is ready.","group":"backups","url":"https://example.com/backups"}'

See Sending for every way to send, and Parameters for everything you can set.

Send a test notification#

Paste your key or complete link. A request is sent only when you select “Send notification.” The key stays in the current page's memory.

Try a notificationSwitch to development

Sends only to the current environment: https://push.breezelabs.dev. Your key is not saved in browser storage.

BreezePreview
Backup complete

Your latest backup is complete.

One message, right when it matters.
More options

Use HTTPS for Apple and Android compatibility. HTTP links are Apple-only.

Production
cURL

The preview hides your key. Copying the command includes the send key you entered.

Read the result#

accepted means Apple or Google accepted the notification for delivery. It does not prove the phone displayed it: connectivity, notification permission, and Focus still apply. If nothing arrives, see the FAQ.

What's next#

Update and withdraw messages · Encrypt notifications · Use Breeze with Shortcuts