# wallabag

> Save pages to wallabag to read later, find and read saved articles, mark them read, star and tag them, and start a workflow when an article is saved, starred or read.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/wallabag

## Actions

### Add annotation

Add a note to an article, about some of its words if you like. It shows in the article's annotations in wallabag.

**Inputs**

- Article (`entry`, text, required): The article's ID, such as one from 'Save article', 'Find articles' or a trigger, its page in wallabag (…/view/42), or the address of the page it was saved from.
- Note (`text`, text, required): The annotation's text.
- Quote (`quote`, text): The words of the article it's about, shown with the note.

**Outputs**

- `created_at` (text): When it was added (ISO 8601)
- `entry_id` (number): The ID of the article it is on
- `id` (number): The annotation's ID
- `link` (text): A link to the article in wallabag
- `quote` (text): The words of the article it is about, if given
- `text` (text): Its text

**Example output**

```json
{
  "created_at": "2026-11-02T10:06:00Z",
  "entry_id": 42,
  "id": 7,
  "link": "https://app.wallabag.it/view/42",
  "quote": "Small teams talk more and wait less.",
  "text": "Worth sharing with the team on Friday."
}
```

### Add tags

Add tags to an article; a new name makes a new tag. Its other tags stay.

**Inputs**

- Article (`entry`, text, required): The article's ID, such as one from 'Save article', 'Find articles' or a trigger, its page in wallabag (…/view/42), or the address of the page it was saved from.
- Tags (`tags`, list, required): The tags to add.

**Outputs**

- `authors` (list): Its authors, when wallabag found them
- `created_at` (text): When it was saved to wallabag (ISO 8601)
- `domain` (text): The page's website, such as blog.example.com
- `id` (number): The article's ID in wallabag
- `is_read` (true/false): Whether it is marked as read (in wallabag's Archive)
- `is_starred` (true/false): Whether it is starred
- `language` (text): Its language, such as en, when wallabag found it
- `link` (text): A link to it in wallabag
- `preview_picture` (text): The address of its preview picture, if any
- `published_at` (text): When the page says it was published (ISO 8601), if it does
- `read_at` (text): When it was marked as read (ISO 8601); empty while unread
- `reading_time` (number): Its estimated reading time, in minutes
- `starred_at` (text): When it was starred (ISO 8601); empty while not starred
- `tags` (list): Its tags, in lower case
- `title` (text): Its title
- `updated_at` (text): When it last changed in wallabag (ISO 8601)
- `url` (text): The address of the page it was saved from

**Example output**

```json
{
  "authors": [
    "Ada Example"
  ],
  "created_at": "2026-11-02T10:00:00Z",
  "domain": "blog.example.com",
  "id": 42,
  "is_read": false,
  "is_starred": true,
  "language": "en",
  "link": "https://app.wallabag.it/view/42",
  "preview_picture": "https://blog.example.com/small-teams.png",
  "published_at": "2026-10-30T08:00:00Z",
  "read_at": "",
  "reading_time": 7,
  "starred_at": "2026-11-02T10:05:00Z",
  "tags": [
    "teams",
    "to-share"
  ],
  "title": "Why small teams ship faster",
  "updated_at": "2026-11-02T10:05:00Z",
  "url": "https://blog.example.com/small-teams"
}
```

### Check if a page is saved

Check whether a page is already saved in wallabag, and get its ID, title and whether it's read or starred if it is.

**Inputs**

- Address (`url`, text, required): The page's address, as it was saved.

**Outputs**

- `id` (number): The saved article's ID; 0 when it isn't saved
- `is_read` (true/false): Whether the saved article is marked as read
- `is_starred` (true/false): Whether the saved article is starred
- `link` (text): A link to the saved article in wallabag
- `saved` (true/false): Whether the page is saved in wallabag
- `tags` (list): The saved article's tags
- `title` (text): The saved article's title
- `url` (text): The page's address

**Example output**

```json
{
  "id": 42,
  "is_read": false,
  "is_starred": true,
  "link": "https://app.wallabag.it/view/42",
  "saved": true,
  "tags": [
    "teams",
    "to-share"
  ],
  "title": "Why small teams ship faster",
  "url": "https://blog.example.com/small-teams"
}
```

### Delete article

Delete an article from wallabag, with its annotations.

**Inputs**

- Article (`entry`, text, required): The article's ID, such as one from 'Save article', 'Find articles' or a trigger, its page in wallabag (…/view/42), or the address of the page it was saved from.

**Outputs**

- `deleted` (true/false): Always true
- `id` (number): The deleted article's ID
- `title` (text): Its title
- `url` (text): The address it was saved from

**Example output**

```json
{
  "deleted": true,
  "id": 42,
  "title": "Why small teams ship faster",
  "url": "https://blog.example.com/small-teams"
}
```

### Find articles

Find saved articles: unread, read or all, starred, with tags, from a website, with words, or saved since a date, newest first or in the order you choose.

**Inputs**

- Read or unread (`status`, text): Which to find. One of: `all`, `unread`, `read` (Read (Archive)). Default: `all`.
- Starred only (`starred`, true/false): Only articles you've starred.
- Tags (`tags`, list): Only articles with all of these tags.
- Website (`domain`, text): Only articles from this website, such as blog.example.com.
- Saved since (`since`, date and time): Only articles saved since this date and time.
- Words (`search`, text): Only articles whose title, text or address has these words, as written.
- Order (`sort`, text): Which come first. One of: `newest` (Newest saved first), `oldest` (Oldest saved first), `updated` (Last changed first). Default: `newest`.
- How many (`limit`, number): The most to list, up to 200. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many are listed
- `entries` (list): The articles found, without their text
- `more` (true/false): Whether more articles match than are listed

**Example output**

```json
{
  "count": 2,
  "entries": [
    {
      "authors": [
        "Ada Example"
      ],
      "created_at": "2026-11-02T10:00:00Z",
      "domain": "blog.example.com",
      "id": 42,
      "is_read": false,
      "is_starred": true,
      "language": "en",
      "link": "https://app.wallabag.it/view/42",
      "preview_picture": "https://blog.example.com/small-teams.png",
      "published_at": "2026-10-30T08:00:00Z",
      "read_at": "",
      "reading_time": 7,
      "starred_at": "2026-11-02T10:05:00Z",
      "tags": [
        "teams",
        "to-share"
      ],
      "title": "Why small teams ship faster",
      "updated_at": "2026-11-02T10:05:00Z",
      "url": "https://blog.example.com/small-teams"
    },
    {
      "authors": [
        "Ada Example"
      ],
      "created_at": "2026-11-02T10:00:00Z",
      "domain": "essays.example.org",
      "id": 41,
      "is_read": false,
      "is_starred": false,
      "language": "en",
      "link": "https://app.wallabag.it/view/41",
      "preview_picture": "https://blog.example.com/small-teams.png",
      "published_at": "2026-10-30T08:00:00Z",
      "read_at": "",
      "reading_time": 12,
      "starred_at": "",
      "tags": [],
      "title": "Notes on careful reading",
      "updated_at": "2026-11-02T10:05:00Z",
      "url": "https://essays.example.org/careful-reading"
    }
  ],
  "more": false
}
```

### Get article

Get a saved article with its text, as plain text and HTML, its reading time and its annotations, such as for an AI summary.

**Inputs**

- Article (`entry`, text, required): The article's ID, such as one from 'Save article', 'Find articles' or a trigger, its page in wallabag (…/view/42), or the address of the page it was saved from.

**Outputs**

- `annotations` (list): Its annotations
- `authors` (list): Its authors, when wallabag found them
- `created_at` (text): When it was saved to wallabag (ISO 8601)
- `domain` (text): The page's website, such as blog.example.com
- `html` (text): The article's text as wallabag saved it, in HTML
- `id` (number): The article's ID in wallabag
- `is_read` (true/false): Whether it is marked as read (in wallabag's Archive)
- `is_starred` (true/false): Whether it is starred
- `language` (text): Its language, such as en, when wallabag found it
- `link` (text): A link to it in wallabag
- `preview_picture` (text): The address of its preview picture, if any
- `published_at` (text): When the page says it was published (ISO 8601), if it does
- `read_at` (text): When it was marked as read (ISO 8601); empty while unread
- `reading_time` (number): Its estimated reading time, in minutes
- `starred_at` (text): When it was starred (ISO 8601); empty while not starred
- `tags` (list): Its tags, in lower case
- `text` (text): The article's text, as plain text
- `title` (text): Its title
- `updated_at` (text): When it last changed in wallabag (ISO 8601)
- `url` (text): The address of the page it was saved from

**Example output**

```json
{
  "annotations": [
    {
      "created_at": "2026-11-02T10:06:00Z",
      "entry_id": 42,
      "id": 7,
      "link": "https://app.wallabag.it/view/42",
      "quote": "Small teams talk more and wait less.",
      "text": "Worth sharing with the team on Friday."
    }
  ],
  "authors": [
    "Ada Example"
  ],
  "created_at": "2026-11-02T10:00:00Z",
  "domain": "blog.example.com",
  "html": "<p>Small teams ship faster.</p><p>They talk more and wait less.</p>",
  "id": 42,
  "is_read": false,
  "is_starred": true,
  "language": "en",
  "link": "https://app.wallabag.it/view/42",
  "preview_picture": "https://blog.example.com/small-teams.png",
  "published_at": "2026-10-30T08:00:00Z",
  "read_at": "",
  "reading_time": 7,
  "starred_at": "2026-11-02T10:05:00Z",
  "tags": [
    "teams",
    "to-share"
  ],
  "text": "Small teams ship faster.\n\nThey talk more and wait less.",
  "title": "Why small teams ship faster",
  "updated_at": "2026-11-02T10:05:00Z",
  "url": "https://blog.example.com/small-teams"
}
```

### List tags

List your tags, with how many articles have each.

**Inputs**: None.

**Outputs**

- `count` (number): How many tags there are
- `tags` (list): Your tags, A to Z

**Example output**

```json
{
  "count": 2,
  "tags": [
    {
      "article_count": 12,
      "id": 3,
      "name": "teams",
      "slug": "t:teams"
    },
    {
      "article_count": 4,
      "id": 5,
      "name": "to-share",
      "slug": "t:to-share"
    }
  ]
}
```

### Mark as read or unread

Mark an article as read, which moves it to wallabag's Archive, or as unread again. One already as asked is left as it is.

**Inputs**

- Article (`entry`, text, required): The article's ID, such as one from 'Save article', 'Find articles' or a trigger, its page in wallabag (…/view/42), or the address of the page it was saved from.
- Read or unread (`read`, text): Whether to mark it read or unread. One of: `read` (Mark as read), `unread` (Mark as unread). Default: `read`.

**Outputs**

- `authors` (list): Its authors, when wallabag found them
- `created_at` (text): When it was saved to wallabag (ISO 8601)
- `domain` (text): The page's website, such as blog.example.com
- `id` (number): The article's ID in wallabag
- `is_read` (true/false): Whether it is marked as read (in wallabag's Archive)
- `is_starred` (true/false): Whether it is starred
- `language` (text): Its language, such as en, when wallabag found it
- `link` (text): A link to it in wallabag
- `preview_picture` (text): The address of its preview picture, if any
- `published_at` (text): When the page says it was published (ISO 8601), if it does
- `read_at` (text): When it was marked as read (ISO 8601); empty while unread
- `reading_time` (number): Its estimated reading time, in minutes
- `starred_at` (text): When it was starred (ISO 8601); empty while not starred
- `tags` (list): Its tags, in lower case
- `title` (text): Its title
- `updated_at` (text): When it last changed in wallabag (ISO 8601)
- `url` (text): The address of the page it was saved from

**Example output**

```json
{
  "authors": [
    "Ada Example"
  ],
  "created_at": "2026-11-02T10:00:00Z",
  "domain": "blog.example.com",
  "id": 42,
  "is_read": true,
  "is_starred": true,
  "language": "en",
  "link": "https://app.wallabag.it/view/42",
  "preview_picture": "https://blog.example.com/small-teams.png",
  "published_at": "2026-10-30T08:00:00Z",
  "read_at": "2026-11-03T21:00:00Z",
  "reading_time": 7,
  "starred_at": "2026-11-02T10:05:00Z",
  "tags": [
    "teams",
    "to-share"
  ],
  "title": "Why small teams ship faster",
  "updated_at": "2026-11-02T10:05:00Z",
  "url": "https://blog.example.com/small-teams"
}
```

### Remove tags

Take tags off an article. Its other tags stay, and a tag it doesn't have is skipped.

**Inputs**

- Article (`entry`, text, required): The article's ID, such as one from 'Save article', 'Find articles' or a trigger, its page in wallabag (…/view/42), or the address of the page it was saved from.
- Tags (`tags`, list, required): The tags to take off.

**Outputs**

- `authors` (list): Its authors, when wallabag found them
- `created_at` (text): When it was saved to wallabag (ISO 8601)
- `domain` (text): The page's website, such as blog.example.com
- `id` (number): The article's ID in wallabag
- `is_read` (true/false): Whether it is marked as read (in wallabag's Archive)
- `is_starred` (true/false): Whether it is starred
- `language` (text): Its language, such as en, when wallabag found it
- `link` (text): A link to it in wallabag
- `not_on_it` (list): The tags asked for that it didn't have
- `preview_picture` (text): The address of its preview picture, if any
- `published_at` (text): When the page says it was published (ISO 8601), if it does
- `read_at` (text): When it was marked as read (ISO 8601); empty while unread
- `reading_time` (number): Its estimated reading time, in minutes
- `removed` (list): The tags taken off it
- `starred_at` (text): When it was starred (ISO 8601); empty while not starred
- `tags` (list): Its tags, in lower case
- `title` (text): Its title
- `updated_at` (text): When it last changed in wallabag (ISO 8601)
- `url` (text): The address of the page it was saved from

**Example output**

```json
{
  "authors": [
    "Ada Example"
  ],
  "created_at": "2026-11-02T10:00:00Z",
  "domain": "blog.example.com",
  "id": 42,
  "is_read": false,
  "is_starred": true,
  "language": "en",
  "link": "https://app.wallabag.it/view/42",
  "not_on_it": [],
  "preview_picture": "https://blog.example.com/small-teams.png",
  "published_at": "2026-10-30T08:00:00Z",
  "read_at": "",
  "reading_time": 7,
  "removed": [
    "to-share"
  ],
  "starred_at": "2026-11-02T10:05:00Z",
  "tags": [
    "teams"
  ],
  "title": "Why small teams ship faster",
  "updated_at": "2026-11-02T10:05:00Z",
  "url": "https://blog.example.com/small-teams"
}
```

### Save article

Save a page to wallabag to read later, with tags, read or starred. wallabag fetches the article's text from the page, or saves the text you give. A page already saved is left as it is.

**Inputs**

- Address (`url`, text, required): The page's address, such as https://example.com/article.
- Title (`title`, text): A title for it. Leave blank to use the page's own.
- Tags (`tags`, list): Tags to give it; a new name makes a new tag.
- Mark as read (`read`, true/false): Save it as read, straight to wallabag's Archive.
- Star it (`starred`, true/false): Save it starred.
- Article text (`content`, text): The article's text, as text or HTML, to save instead of wallabag fetching the page, such as a newsletter from an email. Needs a title.

**Outputs**

- `already_saved` (true/false): Whether the page was already saved, and was answered as it was
- `authors` (list): Its authors, when wallabag found them
- `created_at` (text): When it was saved to wallabag (ISO 8601)
- `domain` (text): The page's website, such as blog.example.com
- `fetched` (true/false): Whether wallabag got the page's text; false when it couldn't reach the page
- `id` (number): The article's ID in wallabag
- `is_read` (true/false): Whether it is marked as read (in wallabag's Archive)
- `is_starred` (true/false): Whether it is starred
- `language` (text): Its language, such as en, when wallabag found it
- `link` (text): A link to it in wallabag
- `preview_picture` (text): The address of its preview picture, if any
- `published_at` (text): When the page says it was published (ISO 8601), if it does
- `read_at` (text): When it was marked as read (ISO 8601); empty while unread
- `reading_time` (number): Its estimated reading time, in minutes
- `starred_at` (text): When it was starred (ISO 8601); empty while not starred
- `tags` (list): Its tags, in lower case
- `title` (text): Its title
- `updated_at` (text): When it last changed in wallabag (ISO 8601)
- `url` (text): The address of the page it was saved from

**Example output**

```json
{
  "already_saved": false,
  "authors": [
    "Ada Example"
  ],
  "created_at": "2026-11-02T10:00:00Z",
  "domain": "blog.example.com",
  "fetched": true,
  "id": 42,
  "is_read": false,
  "is_starred": false,
  "language": "en",
  "link": "https://app.wallabag.it/view/42",
  "preview_picture": "https://blog.example.com/small-teams.png",
  "published_at": "2026-10-30T08:00:00Z",
  "read_at": "",
  "reading_time": 7,
  "starred_at": "",
  "tags": [
    "teams",
    "to-share"
  ],
  "title": "Why small teams ship faster",
  "updated_at": "2026-11-02T10:05:00Z",
  "url": "https://blog.example.com/small-teams"
}
```

### Star or unstar article

Star an article, or unstar it. One already as asked is left as it is.

**Inputs**

- Article (`entry`, text, required): The article's ID, such as one from 'Save article', 'Find articles' or a trigger, its page in wallabag (…/view/42), or the address of the page it was saved from.
- Star or unstar (`starred`, text): Whether to star it or unstar it. One of: `star`, `unstar`. Default: `star`.

**Outputs**

- `authors` (list): Its authors, when wallabag found them
- `created_at` (text): When it was saved to wallabag (ISO 8601)
- `domain` (text): The page's website, such as blog.example.com
- `id` (number): The article's ID in wallabag
- `is_read` (true/false): Whether it is marked as read (in wallabag's Archive)
- `is_starred` (true/false): Whether it is starred
- `language` (text): Its language, such as en, when wallabag found it
- `link` (text): A link to it in wallabag
- `preview_picture` (text): The address of its preview picture, if any
- `published_at` (text): When the page says it was published (ISO 8601), if it does
- `read_at` (text): When it was marked as read (ISO 8601); empty while unread
- `reading_time` (number): Its estimated reading time, in minutes
- `starred_at` (text): When it was starred (ISO 8601); empty while not starred
- `tags` (list): Its tags, in lower case
- `title` (text): Its title
- `updated_at` (text): When it last changed in wallabag (ISO 8601)
- `url` (text): The address of the page it was saved from

**Example output**

```json
{
  "authors": [
    "Ada Example"
  ],
  "created_at": "2026-11-02T10:00:00Z",
  "domain": "blog.example.com",
  "id": 42,
  "is_read": false,
  "is_starred": true,
  "language": "en",
  "link": "https://app.wallabag.it/view/42",
  "preview_picture": "https://blog.example.com/small-teams.png",
  "published_at": "2026-10-30T08:00:00Z",
  "read_at": "",
  "reading_time": 7,
  "starred_at": "2026-11-02T10:05:00Z",
  "tags": [
    "teams",
    "to-share"
  ],
  "title": "Why small teams ship faster",
  "updated_at": "2026-11-02T10:05:00Z",
  "url": "https://blog.example.com/small-teams"
}
```
