Gotify
MessagingSend and manage push notifications through a self-hosted Gotify server. FlowRunner agents deliver prioritized alerts and maintain Gotify applications and clients as part of a workflow.
What This Integration Enables
An agent can push instant alerts the moment a workflow completes, fails, or crosses a threshold, using Gotify priority levels so urgent notifications stand out. It can format status updates as Markdown through message extras, provision and maintain applications and clients, and audit or clean up notification history across one or all applications. Because Get Health and Get Version need no token, an agent can verify the server URL is reachable before it commits to a send.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Prioritized outage alerting on your own infrastructure
A monitoring workflow detects that a job has failed. The agent builds the alert, health-checks the Gotify server with Get Health, then sends a high-priority Create Message so the notification bypasses client limits and reaches the on-call phone. Because the server is self-hosted, the alert never leaves the company perimeter. The agent logs the delivery for later review.
Markdown status digests to a client group
A reporting workflow finishes a nightly run and needs to push a formatted summary. The agent renders the digest as Markdown using message extras, then delivers it with Create Message to the clients subscribed to the reporting application. The recipients get a readable report on their devices rather than a raw log line.
Notification history cleanup with a human gate
An operator wants to clear stale alerts. The agent lists messages across applications, groups them, and prepares a cleanup. Before running Delete All Messages, which is permanent, it pauses and asks a human to confirm the scope. Routine deletes proceed; a full wipe waits for approval.
Human-in-Loop Highlight
A high-priority Gotify alert broadcasts to every client subscribed to an application, and at priority 8 to 10 it can bypass a client's own notification limits. Before the agent fires that kind of broadcast, it pauses and routes the decision to an operator through their preferred channel: "Ready to send a priority 9 alert to all subscribers of the Production application. Confirm broadcast or lower the priority?" This is FlowRunner's human-in-the-loop pattern, where the agent pauses autonomously, presents the choice, and resumes the moment the human answers. Routine low-priority pushes send on their own. The loudest, most disruptive broadcasts get a human decision first.
Agent Capabilities
15 actionsMessages
5- Create Message Sends a push notification using the application token, with an optional title, a priority from 0 to 10, and an extras object for client behavior such as Markdown rendering. Used to deliver the alert or status update at the center of most Gotify workflows.
- Get Messages Retrieves messages received across all applications, most recent first, using the client token. Used to review or audit recent notification history.
- Get Application Messages Retrieves messages for a single application, most recent first. Used to inspect the history of one notification stream.
- Delete Message Deletes a single message by its numeric ID. Used to remove a specific stale or superseded notification.
- Delete All Messages Deletes every message across all applications owned by the client token. Permanent and irreversible, so it belongs behind a confirmation step.
Applications
5- Get Applications Lists all applications registered on the server, each with its ID, name, default priority, and send token. Used to discover which notification streams exist.
- Create Application Creates a new application and returns its send token. Used to stand up a new notification stream that Create Message can target.
- Update Application Updates an application's name, description, or default priority. Used to adjust an existing stream without recreating it.
- Delete Application Deletes an application by its numeric ID, removing its messages and invalidating its send token. Permanent, so it warrants a human check.
- Upload Application Image Uploads an image to use as an application's icon in the Gotify UI. Used to brand a notification stream so recipients recognize its source.
Clients
3- Get Clients Lists all clients registered on the server, each with the token used to read and manage messages. Used to audit which clients can receive and manage notifications.
- Create Client Creates a new client and returns its token. Used to onboard a new device or reader into the Gotify server.
- Delete Client Deletes a client by its numeric ID, invalidating its token. Used to revoke a device that should no longer receive messages.
System
2- Get Health Checks the health of the Gotify server and needs no authentication. Used as a reachability check before an agent commits to sending.
- Get Version Returns the Gotify server version, git commit, and build date. Used to confirm which server build a workflow is talking to.
Start building with Gotify
$100 in credits. No card required. Connect in minutes.