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
| Action | What it does |
|---|---|
| Add annotation | Add a note to an article, about some of its words if you like. |
| Add tags | Add tags to an article; a new name makes a new tag. |
| 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. |
| Delete article | Delete an article from wallabag, with its annotations. |
| 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. |
| 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. |
| List tags | List your tags, with how many articles have each. |
| Mark as read or unread | Mark an article as read, which moves it to wallabag's Archive, or as unread again. |
| Remove tags | Take tags off an article. |
| Save article | Save a page to wallabag to read later, with tags, read or starred. |
| Star or unstar article | Star 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
- Article
entrytextRequired - 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
texttextRequired - The annotation's text.
- Quote
quotetext - 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
- Article
entrytextRequired - 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
tagslistRequired - 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
- Address
urltextRequired - 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
- Article
entrytextRequired - 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 unread
statustext - Which to find.One of:
all,unread,read(Read (Archive)). Default:all. - Starred only
starredtrue/false - Only articles you've starred.
- Tags
tagslist - Only articles with all of these tags.
- Website
domaintext - Only articles from this website, such as blog.example.com.
- Saved since
sincedate and time - Only articles saved since this date and time.
- Words
searchtext - Only articles whose title, text or address has these words, as written.
- Order
sorttext - Which come first.One of:
newest(Newest saved first),oldest(Oldest saved first),updated(Last changed first). Default:newest. - How many
limitnumber - 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
- Article
entrytextRequired - 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
- Article
entrytextRequired - 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
readtext - 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
- Article
entrytextRequired - 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
tagslistRequired - 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
- Address
urltextRequired - The page's address, such as https://example.com/article.
- Title
titletext - A title for it. Leave blank to use the page's own.
- Tags
tagslist - Tags to give it; a new name makes a new tag.
- Mark as read
readtrue/false - Save it as read, straight to wallabag's Archive.
- Star it
starredtrue/false - Save it starred.
- Article text
contenttext - 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
- Article
entrytextRequired - 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
starredtext - 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"
}