Getting Started

NotifyHero lets you send push notifications to your phone or desktop via scripts from any computer, using simple HTTP PUT or POST requests. Use it to notify yourself when scripts fail, or long-running commands complete.

Step 1: Get the app

To receive notifications on your phone, install the NotifyHero app:

Once installed, open it and subscribe to a topic of your choosing. Topics don't have to explicitly be created, so just pick a name and use it later when you publish a message.

Tip: Create a free account to reserve topic names, join organizations, and unlock additional features like phone call notifications.

For this guide, we'll just use mytopic as our topic name.

Step 2: Send a message

Now let's send a message to our topic. It's easy in every language, since we're just using HTTP PUT/POST. The message is in the request body.

Using curl

curl -d "Backup successful 😀" https://app.notifyhero.com/mytopic

Using JavaScript

fetch('https://app.notifyhero.com/mytopic', {
    method: 'POST',
    body: 'Backup successful 😀'
})

Using Python

import requests

requests.post("https://app.notifyhero.com/mytopic",
    data="Backup successful 😀".encode(encoding='utf-8'))

Using Go

http.Post("https://app.notifyhero.com/mytopic", "text/plain",
    strings.NewReader("Backup successful 😀"))

Using PHP

file_get_contents('https://app.notifyhero.com/mytopic', false, stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: text/plain',
        'content' => 'Backup successful 😀'
    ]
]));

What's next?

That's it! You're all set. Go play and read the rest of the docs:

Power Features

Take NotifyHero to the next level with: