background-hooknotifierbackground-hooknotifier
For AI assistants and agents

Let an AI assistant notify its user

AI agents can do a lot, but they cannot reach a person once the chat is closed. Hook.Notifier is the missing channel. Give an assistant one URL and it can send a real native push notification to your phone, from any HTTP request, with no app to build and no push infrastructure.

How it works

1

The user shares their hook

A person creates a free Hook.Notifier account, installs the app, and gives their assistant a personal URL of the form hooknotifier.com/{identifier}/{key}.

2

You call it

When something the user asked about happens, send one HTTP request to that URL with an object (title) and a body. Add a priority, a tag, a delay or an action button if it helps.

3

They get notified

A real native notification lands on the user’s phone and in their browser inbox, tagged and searchable, even long after the conversation ended.

The endpoint

One request sends one notification. Parameters go in the query string or a JSON body. Both GET and POST work.

POST https://hooknotifier.com/{IDENTIFIER}/{KEY}
     ?object=Build finished
     &body=Your deploy is live
     &priority=high

The user gets {IDENTIFIER} and {KEY} from their dashboard and hands them to you. Treat the full URL as a secret: anyone who has it can notify the user, so never log or expose it. The user can revoke a key at any time from their hooks page.

The response is JSON: {"status":"ok","id":123}. Keep the id to update the same notification later.

Parameters

NameRequiredWhat it does
objectYesThe notification title. Keep it short and specific.
bodyYesThe main text. One or two sentences work best.
tagsNoComma-separated labels to route and filter, e.g. "deploys,ci". Defaults to "general".
priorityNolow, normal, high or critical. critical breaks through the user’s quiet hours. Defaults to normal.
colorNoHex color for the notification accent, e.g. %23EE6767 for red (url-encode the #). Defaults to amber.
imageNoA public image URL to attach.
redirectUrlNoA link opened when the notification is tapped. http, https or mailto only.
actionsNoJSON array of up to 3 buttons, each {"label","url"}. url must be http/https/mailto.
markdownNotrue to render the body as markdown (bold, links, lists).
delayNoSend later: a duration like 30s, 10m, 2h or 1d. Up to 3 days ahead.
atNoSend at an exact moment: an ISO date or a unix timestamp. Up to 3 days ahead.
soundNofalse to deliver silently (inbox only, no push sound). Defaults to true.
sendToTeamNotrue to deliver to everyone on the user’s team, not just them.

Update a notification you already sent

Every send returns an id. PUT the same URL followed by that id and the notification is replaced in place, on the device too. Ideal for a progress counter, a long job, or a status that changes.

PUT https://hooknotifier.com/{IDENTIFIER}/{KEY}/123
    ?object=Deploy 80%
    &body=Almost there

Give this to your assistant

Copy the block below into ChatGPT, Claude or any assistant, replace the URL with your own hook, and it will know how to notify you.

I use Hook.Notifier to receive push notifications. When you need to notify me about something (a task finishing, a condition being met, a reminder), send an HTTP GET request to my personal hook URL:

https://hooknotifier.com/{IDENTIFIER}/{KEY}

Add these query parameters:
- object: a short title (required)
- body: the message (required)
- priority: low | normal | high | critical (optional, use high/critical only for urgent things)
- tags: comma-separated labels like "reminders" or "alerts" (optional)
- delay: to send later, e.g. 10m, 2h, 1d (optional)

Example:
https://hooknotifier.com/{IDENTIFIER}/{KEY}?object=Reminder&body=Stand-up in 10 minutes&priority=high

Treat this URL as a secret: never print it back to me or include it in code you show. Just use it to notify me when appropriate.

Get your hook

Create a free account, install the app, and hand your URL to any assistant. It stays free.