wallabag

App · 11 actions

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.

Actions

ActionWhat it does
Add annotationAdd a note to an article, about some of its words if you like.
Add tagsAdd tags to an article; a new name makes a new tag.
Check if a page is savedCheck whether a page is already saved in wallabag, and get its ID, title and whether it's read or starred if it is.
Delete articleDelete an article from wallabag, with its annotations.
Find articlesFind 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.
Get articleGet a saved article with its text, as plain text and HTML, its reading time and its annotations, such as for an AI summary.
List tagsList your tags, with how many articles have each.
Mark as read or unreadMark an article as read, which moves it to wallabag's Archive, or as unread again.
Remove tagsTake tags off an article.
Save articleSave a page to wallabag to read later, with tags, read or starred.
Star or unstar articleStar an article, or unstar it.

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

ArticleentrytextRequired
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.
NotetexttextRequired
The annotation's text.
Quotequotetext
The words of the article it's about, shown with the note.

Outputs

created_attext
When it was added (ISO 8601)
entry_idnumber
The ID of the article it is on
idnumber
The annotation's ID
linktext
A link to the article in wallabag
quotetext
The words of the article it is about, if given
texttext
Its text
Example output
{
  "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

ArticleentrytextRequired
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.
TagstagslistRequired
The tags to add.

Outputs

authorslist
Its authors, when wallabag found them
created_attext
When it was saved to wallabag (ISO 8601)
domaintext
The page's website, such as blog.example.com
idnumber
The article's ID in wallabag
is_readtrue/false
Whether it is marked as read (in wallabag's Archive)
is_starredtrue/false
Whether it is starred
languagetext
Its language, such as en, when wallabag found it
linktext
A link to it in wallabag
preview_picturetext
The address of its preview picture, if any
published_attext
When the page says it was published (ISO 8601), if it does
read_attext
When it was marked as read (ISO 8601); empty while unread
reading_timenumber
Its estimated reading time, in minutes
starred_attext
When it was starred (ISO 8601); empty while not starred
tagslist
Its tags, in lower case
titletext
Its title
updated_attext
When it last changed in wallabag (ISO 8601)
urltext
The address of the page it was saved from
Example output
{
  "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

AddressurltextRequired
The page's address, as it was saved.

Outputs

idnumber
The saved article's ID; 0 when it isn't saved
is_readtrue/false
Whether the saved article is marked as read
is_starredtrue/false
Whether the saved article is starred
linktext
A link to the saved article in wallabag
savedtrue/false
Whether the page is saved in wallabag
tagslist
The saved article's tags
titletext
The saved article's title
urltext
The page's address
Example output
{
  "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

ArticleentrytextRequired
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

deletedtrue/false
Always true
idnumber
The deleted article's ID
titletext
Its title
urltext
The address it was saved from
Example output
{
  "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 unreadstatustext
Which to find.One of: all, unread, read (Read (Archive)). Default: all.
Starred onlystarredtrue/false
Only articles you've starred.
Tagstagslist
Only articles with all of these tags.
Websitedomaintext
Only articles from this website, such as blog.example.com.
Saved sincesincedate and time
Only articles saved since this date and time.
Wordssearchtext
Only articles whose title, text or address has these words, as written.
Ordersorttext
Which come first.One of: newest (Newest saved first), oldest (Oldest saved first), updated (Last changed first). Default: newest.
How manylimitnumber
The most to list, up to 200. Defaults to 25.From 1 to 200.

Outputs

countnumber
How many are listed
entrieslist
The articles found, without their text
moretrue/false
Whether more articles match than are listed
Example output
{
  "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

ArticleentrytextRequired
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

annotationslist
Its annotations
authorslist
Its authors, when wallabag found them
created_attext
When it was saved to wallabag (ISO 8601)
domaintext
The page's website, such as blog.example.com
htmltext
The article's text as wallabag saved it, in HTML
idnumber
The article's ID in wallabag
is_readtrue/false
Whether it is marked as read (in wallabag's Archive)
is_starredtrue/false
Whether it is starred
languagetext
Its language, such as en, when wallabag found it
linktext
A link to it in wallabag
preview_picturetext
The address of its preview picture, if any
published_attext
When the page says it was published (ISO 8601), if it does
read_attext
When it was marked as read (ISO 8601); empty while unread
reading_timenumber
Its estimated reading time, in minutes
starred_attext
When it was starred (ISO 8601); empty while not starred
tagslist
Its tags, in lower case
texttext
The article's text, as plain text
titletext
Its title
updated_attext
When it last changed in wallabag (ISO 8601)
urltext
The address of the page it was saved from
Example output
{
  "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

countnumber
How many tags there are
tagslist
Your tags, A to Z
Example output
{
  "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

ArticleentrytextRequired
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 unreadreadtext
Whether to mark it read or unread.One of: read (Mark as read), unread (Mark as unread). Default: read.

Outputs

authorslist
Its authors, when wallabag found them
created_attext
When it was saved to wallabag (ISO 8601)
domaintext
The page's website, such as blog.example.com
idnumber
The article's ID in wallabag
is_readtrue/false
Whether it is marked as read (in wallabag's Archive)
is_starredtrue/false
Whether it is starred
languagetext
Its language, such as en, when wallabag found it
linktext
A link to it in wallabag
preview_picturetext
The address of its preview picture, if any
published_attext
When the page says it was published (ISO 8601), if it does
read_attext
When it was marked as read (ISO 8601); empty while unread
reading_timenumber
Its estimated reading time, in minutes
starred_attext
When it was starred (ISO 8601); empty while not starred
tagslist
Its tags, in lower case
titletext
Its title
updated_attext
When it last changed in wallabag (ISO 8601)
urltext
The address of the page it was saved from
Example output
{
  "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

ArticleentrytextRequired
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.
TagstagslistRequired
The tags to take off.

Outputs

authorslist
Its authors, when wallabag found them
created_attext
When it was saved to wallabag (ISO 8601)
domaintext
The page's website, such as blog.example.com
idnumber
The article's ID in wallabag
is_readtrue/false
Whether it is marked as read (in wallabag's Archive)
is_starredtrue/false
Whether it is starred
languagetext
Its language, such as en, when wallabag found it
linktext
A link to it in wallabag
not_on_itlist
The tags asked for that it didn't have
preview_picturetext
The address of its preview picture, if any
published_attext
When the page says it was published (ISO 8601), if it does
read_attext
When it was marked as read (ISO 8601); empty while unread
reading_timenumber
Its estimated reading time, in minutes
removedlist
The tags taken off it
starred_attext
When it was starred (ISO 8601); empty while not starred
tagslist
Its tags, in lower case
titletext
Its title
updated_attext
When it last changed in wallabag (ISO 8601)
urltext
The address of the page it was saved from
Example output
{
  "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

AddressurltextRequired
The page's address, such as https://example.com/article.
Titletitletext
A title for it. Leave blank to use the page's own.
Tagstagslist
Tags to give it; a new name makes a new tag.
Mark as readreadtrue/false
Save it as read, straight to wallabag's Archive.
Star itstarredtrue/false
Save it starred.
Article textcontenttext
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_savedtrue/false
Whether the page was already saved, and was answered as it was
authorslist
Its authors, when wallabag found them
created_attext
When it was saved to wallabag (ISO 8601)
domaintext
The page's website, such as blog.example.com
fetchedtrue/false
Whether wallabag got the page's text; false when it couldn't reach the page
idnumber
The article's ID in wallabag
is_readtrue/false
Whether it is marked as read (in wallabag's Archive)
is_starredtrue/false
Whether it is starred
languagetext
Its language, such as en, when wallabag found it
linktext
A link to it in wallabag
preview_picturetext
The address of its preview picture, if any
published_attext
When the page says it was published (ISO 8601), if it does
read_attext
When it was marked as read (ISO 8601); empty while unread
reading_timenumber
Its estimated reading time, in minutes
starred_attext
When it was starred (ISO 8601); empty while not starred
tagslist
Its tags, in lower case
titletext
Its title
updated_attext
When it last changed in wallabag (ISO 8601)
urltext
The address of the page it was saved from
Example output
{
  "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

ArticleentrytextRequired
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 unstarstarredtext
Whether to star it or unstar it.One of: star, unstar. Default: star.

Outputs

authorslist
Its authors, when wallabag found them
created_attext
When it was saved to wallabag (ISO 8601)
domaintext
The page's website, such as blog.example.com
idnumber
The article's ID in wallabag
is_readtrue/false
Whether it is marked as read (in wallabag's Archive)
is_starredtrue/false
Whether it is starred
languagetext
Its language, such as en, when wallabag found it
linktext
A link to it in wallabag
preview_picturetext
The address of its preview picture, if any
published_attext
When the page says it was published (ISO 8601), if it does
read_attext
When it was marked as read (ISO 8601); empty while unread
reading_timenumber
Its estimated reading time, in minutes
starred_attext
When it was starred (ISO 8601); empty while not starred
tagslist
Its tags, in lower case
titletext
Its title
updated_attext
When it last changed in wallabag (ISO 8601)
urltext
The address of the page it was saved from
Example output
{
  "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"
}

On this page