Skip to content
HALOWERK

Datenwerk

ntfy push

Publishes one message to https://<your ntfy server>/<topic> using the ntfy publish API, with optional title, priority 1–5, tags (emoji shortcodes), click URL, Markdown flag and Bearer access token for protected topics. The token is sent only to that server and never stored or returned. Returns the message ID and time reported by the server. Note: the public ntfy.sh limits requests per sending IP; for regular use run your own server or use an access token.

POST https://daten.halowerk.com/v1/ntfy-push

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
serverstringYes
topicstringYes
messagestringYes
titlestringNo
priorityintegerNo
tagsarrayNo
clickstringNo
markdownbooleanNo
access_tokenstringNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "server",
    "topic",
    "message"
  ],
  "properties": {
    "server": {
      "type": "string",
      "format": "uri",
      "maxLength": 300
    },
    "topic": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$"
    },
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "priority": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "default": 3
    },
    "tags": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_+-]{1,40}$"
      }
    },
    "click": {
      "type": "string",
      "format": "uri",
      "maxLength": 1000
    },
    "markdown": {
      "type": "boolean",
      "default": false
    },
    "access_token": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200
    }
  }
}

Open original schema

Published input example

{
  "server": "https://ntfy.sh",
  "topic": "halowerk-catalogue-status",
  "message": "Backup finished",
  "title": "Nightly job",
  "priority": 3,
  "tags": [
    "white_check_mark"
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →