# Gotify

> Send push notifications to your phone with Gotify, your own notification server: titles, priorities, Markdown, links and images. List and clean up messages, and start a workflow when one arrives.

App · 5 actions. Web page: https://docs.lodol.com/docs/integrations/gotify

## Actions

### Delete message

Delete one message from Gotify, by its ID. Needs a client token on the connection.

**Inputs**

- Message ID (`message`, text, required): The message's ID, as a step that sent or listed it gives.

**Outputs**

- `deleted` (true/false): True once it's deleted
- `id` (number): The deleted message's ID

**Example output**

```json
{
  "deleted": true,
  "id": 128
}
```

### Delete messages

Clean up Gotify: delete an application's messages, or every application's, all of them or only those older than some days. Needs a client token on the connection.

**Inputs**

- Application (`application`, text, required): Whose messages to delete: one application, or Every application.
- Older than (days) (`older_than_days`, number): Only delete messages older than this many days, such as 30. Leave blank to delete them all. From 0 to 3650.

**Outputs**

- `application` (text): The application's name, or Every application
- `application_id` (number): The application's ID; 0 for every application
- `deleted_count` (number): How many messages were deleted
- `has_more` (true/false): Whether old messages are left for another run
- `older_than` (text): Messages sent before this time were deleted (ISO 8601, UTC); empty when all were

**Example output**

```json
{
  "application": "Backups",
  "application_id": 3,
  "deleted_count": 12,
  "has_more": false,
  "older_than": "2026-10-07T02:06:37Z"
}
```

### List applications

List the applications in Gotify that messages are sent as, with their IDs and default priorities. Needs a client token on the connection.

**Inputs**: None.

**Outputs**

- `applications` (list): The applications
- `count` (number): How many applications there are

**Example output**

```json
{
  "applications": [
    {
      "created_at": "2026-11-01T09:00:00Z",
      "default_priority": 5,
      "description": "Nightly backups of the file server",
      "id": 3,
      "image_url": "https://gotify.example.com/static/defaultapp.png",
      "internal": false,
      "last_used": "2026-11-06T02:06:37Z",
      "name": "Backups"
    }
  ],
  "count": 1
}
```

### List messages

List the newest messages in Gotify, from every application or one, newest first. Needs a client token on the connection.

**Inputs**

- Application (`application`, text): Only this application's messages. Leave blank for every application.
- How many (`limit`, number): The most to list, newest first. Defaults to 25. From 1 to 500.

**Outputs**

- `count` (number): How many messages were listed
- `has_more` (true/false): Whether there are more than were listed
- `messages` (list): The messages, newest first

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "messages": [
    {
      "application": "Backups",
      "application_id": 3,
      "click_url": "https://backups.example.com/runs/42",
      "date": "2026-11-06T02:06:37Z",
      "extras": {
        "client::display": {
          "contentType": "text/markdown"
        },
        "client::notification": {
          "click": {
            "url": "https://backups.example.com/runs/42"
          }
        }
      },
      "id": 128,
      "image_url": "",
      "markdown": true,
      "message": "**Nightly backup** finished in 4 minutes.",
      "priority": 5,
      "priority_level": "Normal",
      "title": "Backup finished"
    }
  ]
}
```

### Send notification

Send a push notification to the phones and browsers showing Gotify, with a title, a priority, Markdown, a link to open when it's tapped and a big image.

**Inputs**

- Message (`message`, text, required): What the notification says.
- Title (`title`, text): Its title. Leave blank and Gotify uses the application's name.
- Priority (`priority`, text): How strongly phones get your attention. Leave blank for the application's default priority. One of: `0` (None: listed in Gotify, no notification (0)), `2` (Low: an icon, no sound (2)), `5` (Normal: with a sound (5)), `8` (High: sound and vibration (8)), `10` (Highest (10)).
- Markdown (`markdown`, true/false): Show the message as Markdown: **bold**, lists, links and pictures.
- Link to open (`click_url`, text): A link the Android app opens when the notification is tapped, instead of opening Gotify.
- Big image (`image_url`, text): A web link to a picture the Android app shows large in the notification.
- Application (`application`, text): Send as this application. Leave blank to send as the one whose token the connection has; another one needs a client token on the connection.

**Outputs**

- `application` (text): The application's name; empty when the connection has no client token
- `application_id` (number): The ID of the application it was sent as
- `click_url` (text): The link opened when the notification is tapped; may be empty
- `date` (text): When it was sent (ISO 8601, UTC)
- `extras` (object): Everything sent with it as Gotify extras, as sent
- `id` (number): The message's ID
- `image_url` (text): The big image shown in the notification; may be empty
- `markdown` (true/false): Whether it is shown as Markdown
- `message` (text): What it says
- `priority` (number): Its priority, usually 0 to 10
- `priority_level` (text): How the Android app shows it: None (no notification), Low (an icon), Normal (with a sound) or High (sound and vibration)
- `title` (text): Its title; Gotify uses the application's name when none is given

**Example output**

```json
{
  "application": "Backups",
  "application_id": 3,
  "click_url": "https://backups.example.com/runs/42",
  "date": "2026-11-06T02:06:37Z",
  "extras": {
    "client::display": {
      "contentType": "text/markdown"
    },
    "client::notification": {
      "click": {
        "url": "https://backups.example.com/runs/42"
      }
    }
  },
  "id": 128,
  "image_url": "",
  "markdown": true,
  "message": "**Nightly backup** finished in 4 minutes.",
  "priority": 5,
  "priority_level": "Normal",
  "title": "Backup finished"
}
```
