uup

n8n nodes for You Up? uptime monitoring: send a Heartbeat when a workflow succeeds, and read status, Monitors and Incidents.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.2
Author: You Up?

Documentation

n8n-nodes-uup

You Up? is an uptime monitoring service that checks your websites, APIs, servers and cron jobs from several locations and alerts you by email, Slack, WhatsApp, SMS and more, only when an outage is confirmed.

This package adds two n8n nodes for You Up?:

  • You Up? Heartbeat calls a Heartbeat URL when your workflow succeeds. If a run fails, or the workflow stops running, no call arrives and You Up? alerts you.
  • You Up? reads status, Projects, Monitors and Incidents from the You Up? API.

Installation · Heartbeat · Operations · Credentials · Compatibility · Resources

Installation

Follow the installation guide in the n8n community nodes documentation, and install n8n-nodes-uup.

Heartbeat

Use this node to find out when a scheduled workflow stops working.

  1. In You Up?, create a Heartbeat Monitor. Give it the same schedule as your workflow.
  2. Copy the Heartbeat URL from the Monitor's Checks card.
  3. In n8n, add You Up? Heartbeat as the last node of the workflow, and paste the URL.

The node runs only when every node before it succeeded, so a failed run sends nothing. If no call arrives in time, You Up? opens an Incident and alerts you.

Things to know:

  • The node calls the URL once per run, however many items reach it. It returns one item: status (sent or failed), statusCode, attempts and sentAt.
  • Each try waits up to 10 seconds. After a network error or a server error, the node tries up to 3 more times. You can change both under Options.
  • By default, a failed call does not stop the workflow, and the node reports the failure in its output. To stop the workflow instead, turn on Options → Fail on Error.
  • n8n does not run a node that gets no items. If the node before the Heartbeat can return no items on a good run, turn on Settings → Always Output Data on that node.
  • Anyone who has the Heartbeat URL can call it. Keep it private: the node masks it like a password.

The node needs no credentials.

Operations

The You Up? node reads data. It does not change anything in your account.

Resource Operation What it returns
Status Get One item for each Project: its Monitors that are not ok, its open Incidents and its open Regional outages. You can limit it to one Project.
Project Get Many The Projects your API token can read.
Monitor Get One Monitor, with its Checks, their status and any open Incident.
Monitor Get Many A Project's Monitors. Filter by type, state, or words in the name or target.
Incident Get One Incident, with who acknowledged it and who ended it.
Incident Get Evidence Where an Incident stopped, in plain words, and what each location saw.
Incident Get Many A Project's Incidents, newest first. Filter by Monitor, and by open or ended.

The node can also be used as a tool by n8n's AI Agent.

Credentials

The You Up? node needs a You Up? API token. The You Up? Heartbeat node needs none.

  1. Sign in to You Up?. In the sidebar, open API tokens and press New token.
  2. Choose the Project it reaches, or every Project. A Read-only token is enough for this node.
  3. Copy the token (uup_api_…). You Up? shows it only once.
  4. In n8n, create a You Up? API credential and paste the token.

Only the owner and admins of an Organization can make tokens. See API tokens.

Compatibility

Needs n8n 2.46.1 or later.

Resources

License

MIT

Discussion