Pushover

Send push notifications to your phone, tablet, or desktop with Pushover: choose a sound and priority, attach a link, raise an emergency alert that repeats until someone acknowledges it, and check your remaining monthly quota.

Actions

Action	What it does
Cancel Pushover retries	Stop an emergency-priority notification from being retried any further, without waiting for someone to acknowledge it.
Check Pushover message quota	Check how many messages your Pushover application has left this month and when the counter resets.
Check Pushover receipt	Check whether an emergency-priority notification has been acknowledged yet, and by whom.
List Pushover sounds	List the notification sounds your Pushover application can ask for, with the name to pass as the sound of a notification and the label the Pushover apps show for it.
Send Pushover notification	Send a push notification to your phone, tablet, or desktop.
Validate Pushover user	Check that a Pushover user or group key is valid and has at least one active device.

Cancel Pushover retries

Stop an emergency-priority notification from being retried any further, without waiting for someone to acknowledge it. Use this when the condition that raised the alert has cleared on its own.

Inputs

ReceiptreceipttextRequired: The receipt returned by Send Pushover notification when it was sent at emergency priority.

Outputs

None.

Example output

{}

Check Pushover message quota

Check how many messages your Pushover application has left this month and when the counter resets. Useful as a guard before a workflow that sends in bulk.

Inputs

None.

Outputs

limitnumber: Messages the application may send per month.
remainingnumber: Messages left before the limit is reached.
reset_atnumber: When the counter resets, as a Unix timestamp.

Example output

{
  "limit": 10000,
  "remaining": 9873,
  "reset_at": 1772323200
}

Check Pushover receipt

Check whether an emergency-priority notification has been acknowledged yet, and by whom. Poll this to hold a workflow until someone confirms they have seen an alert.

Inputs

ReceiptreceipttextRequired: The receipt returned by Send Pushover notification when it was sent at emergency priority.

Outputs

acknowledgedtrue/false: True once someone has acknowledged the notification, which also stops the retries.
acknowledged_atnumber: When it was acknowledged, as a Unix timestamp. Null if it has not been.
acknowledged_bytext: User key of whoever acknowledged it, which is how you tell who responded in a delivery group.
acknowledged_by_devicetext: Name of the device they acknowledged it on.
called_backtrue/false: True once Pushover has POSTed to the callback URL, if one was given.
called_back_atnumber: When the callback fired, as a Unix timestamp.
expiredtrue/false: True once Pushover has stopped retrying because the expire window passed without an acknowledgement.
expires_atnumber: When retrying stops, as a Unix timestamp.
last_delivered_atnumber: When the most recent retry went out, as a Unix timestamp.

Example output

{
  "acknowledged": true,
  "acknowledged_at": 1769610600,
  "acknowledged_by": "uQiRzpo4DXghDmr9QzzfQu27cmVRsG",
  "acknowledged_by_device": "iphone",
  "called_back": false,
  "called_back_at": null,
  "expired": false,
  "expires_at": 1769614140,
  "last_delivered_at": 1769610540
}

List Pushover sounds

List the notification sounds your Pushover application can ask for, with the name to pass as the sound of a notification and the label the Pushover apps show for it.

Inputs

None.

Outputs

countnumber: Number of sounds returned.
soundslist: Available sounds, in alphabetical order.

Example output

{
  "count": 3,
  "sounds": [
    {
      "label": "Magic",
      "name": "magic"
    },
    {
      "label": "Pushover (default)",
      "name": "pushover"
    },
    {
      "label": "Siren",
      "name": "siren"
    }
  ]
}

Send Pushover notification

Send a push notification to your phone, tablet, or desktop. Set the priority to emergency to have Pushover keep retrying until someone acknowledges it, which returns a receipt you can poll.

Inputs

MessagemessagetextRequired: The notification body, up to 1024 characters. Supports basic HTML tags when html is turned on.
Titletitletext: Heading shown above the message, up to 250 characters. Defaults to your application's name.
User keyuser_keytext: Who to notify, as a Pushover user key or delivery group key. Leave blank to use the key saved with the connection.
Priorityprioritynumber: How intrusive the notification is. Emergency repeats until acknowledged; high bypasses the user's quiet hours; lowest delivers with no alert at all.One of: -2 (Lowest (no notification)), -1 (Low (no sound or vibration)), 0 (Normal), 1 (High (bypasses quiet hours)), 2 (Emergency (repeats until acknowledged)).
Soundsoundtext: Which sound to play, e.g. pushover, siren, magic, or none for silence. Use List Pushover sounds to see them all. Defaults to the user's own setting.
URLurltext: A link to show under the message, up to 512 characters.
URL titleurl_titletext: Text to show for the link instead of the raw URL, up to 100 characters.
Devicedevicetext: Send only to one of the user's devices, by its Pushover device name. Leave blank to reach all of them.
HTMLhtmltrue/false: Render basic HTML in the message, such as <b> and <a>. Cannot be combined with monospace.
Monospacemonospacetrue/false: Render the message in a fixed-width font, useful for logs or tables. Cannot be combined with html.
Ttlttlnumber: Seconds after which the notification is removed from the user's devices automatically.
Retryretrynumber: Emergency priority only: how many seconds between retries, at least 30. Defaults to 60.
Expireexpirenumber: Emergency priority only: how many seconds to keep retrying before giving up, up to 10800 (3 hours). Defaults to 3600.
Callbackcallbacktext: Emergency priority only: a URL Pushover will POST to once someone acknowledges the notification.
Tagstagstext: Emergency priority only: comma-separated labels you can later use to cancel a batch of notifications at once.

Outputs

receipttext: Tracking id for an emergency-priority notification, used by Check Pushover receipt and Cancel Pushover retries. Null at every other priority.
request_idtext: Pushover's id for this request, which their support asks for when tracing a delivery.

Example output

{
  "receipt": "rIcHaRdS0nR3c31pT0000000000000",
  "request_id": "e460545e-3f4a-4b8f-9c0d-5f8e2b1a7c33"
}

Validate Pushover user

Check that a Pushover user or group key is valid and has at least one active device. Use this before sending to a key that came from somewhere else in the workflow, so a bad key fails visibly rather than silently going nowhere.

Inputs

User keyuser_keytext: Who to notify, as a Pushover user key or delivery group key. Leave blank to use the key saved with the connection.
Devicedevicetext: Also check that this specific device name exists on the account.

Outputs

deviceslist: Names of the devices registered to the key, which can be passed as the device of a notification.
is_grouptrue/false: True when the key names a delivery group rather than a single user.
licenseslist: Platforms the user is licensed for, e.g. Android, iOS, Desktop.

Example output

{
  "devices": [
    "iphone",
    "desktop"
  ],
  "is_group": false,
  "licenses": [
    "iOS",
    "Desktop"
  ]
}

ActionsCopy Anchor Link

Cancel Pushover retriesCopy Anchor Link

Inputs

Outputs

Check Pushover message quotaCopy Anchor Link

Inputs

Outputs

Check Pushover receiptCopy Anchor Link

Inputs

Outputs

List Pushover soundsCopy Anchor Link

Inputs

Outputs

Send Pushover notificationCopy Anchor Link

Inputs

Outputs

Validate Pushover userCopy Anchor Link

Inputs

Outputs

On this page

Actions

Cancel Pushover retries

Check Pushover message quota

Check Pushover receipt

List Pushover sounds

Send Pushover notification

Validate Pushover user