# Readwise

> Save links to Readwise Reader to read later, organise them, and work with your Readwise highlights: add, tag and find them, and get your daily review. Start a workflow when you highlight something or save a document.

App · 13 actions. Web page: https://docs.lodol.com/docs/integrations/readwise

## Actions

### Add highlight

Add a highlight to Readwise, filed under the book or article it's from.

**Inputs**

- Highlight (`text`, text, required): The highlighted words.
- From (`title`, text): The book or article's title. Leave empty to file it under Quotes.
- Author (`author`, text): Its author.
- Link (`source_url`, text): The page it's from, starting with https://.
- Kind (`category`, text): What it's from. Defaults to an article with a link, otherwise a book. One of: `books` (Book), `articles` (Article), `tweets` (Tweet), `podcasts` (Podcast).
- Note (`note`, text): Your note on it.
- Highlighted (`highlighted_at`, date and time): When it was highlighted. Leave empty for now.

**Outputs**

- `book_id` (number): The book or article it's from
- `book_title` (text): The book or article it was filed under
- `color` (text): yellow, blue, pink, orange, green or purple
- `created_at` (text): When it was added to Readwise (ISO 8601)
- `highlighted_at` (text): When it was highlighted (ISO 8601)
- `id` (number): The highlight's number
- `note` (text): Your note on it
- `readwise_url` (text): Its link in Readwise
- `tags` (list): Its tags
- `text` (text): The highlighted words
- `updated` (text): When it last changed (ISO 8601)
- `url` (text): A link to where it is in the source, if any

**Example output**

```json
{
  "book_id": 2608,
  "book_title": "How to Take Smart Notes",
  "color": "yellow",
  "created_at": "2026-10-28T09:00:05Z",
  "highlighted_at": "2026-10-28T09:00:00Z",
  "id": 503017,
  "note": "Use in Friday's talk",
  "readwise_url": "https://readwise.io/open/503017",
  "tags": [
    "favorite"
  ],
  "text": "Writing is not the outcome of thinking; it is the medium in which thinking takes place.",
  "updated": "2026-10-28T09:00:05Z",
  "url": ""
}
```

### Change highlight

Change a highlight's words, note or colour.

**Inputs**

- Highlight (`highlight`, text, required): The highlight's number, from 'Add highlight' or 'List highlights', or its readwise.io link.
- Highlight (`text`, text): New words. Leave empty to keep them.
- Note (`note`, text): A new note, replacing the one there. Leave empty to keep it.
- Colour (`color`, text): A new colour. Leave empty to keep it. One of: `yellow`, `blue`, `pink`, `orange`, `green`, `purple`.

**Outputs**

- `book_id` (number): The book or article it's from
- `color` (text): yellow, blue, pink, orange, green or purple
- `created_at` (text): When it was added to Readwise (ISO 8601)
- `highlighted_at` (text): When it was highlighted (ISO 8601)
- `id` (number): The highlight's number
- `note` (text): Your note on it
- `readwise_url` (text): Its link in Readwise
- `tags` (list): Its tags
- `text` (text): The highlighted words
- `updated` (text): When it last changed (ISO 8601)
- `url` (text): A link to where it is in the source, if any

**Example output**

```json
{
  "book_id": 2608,
  "color": "yellow",
  "created_at": "2026-10-28T09:00:05Z",
  "highlighted_at": "2026-10-28T09:00:00Z",
  "id": 503017,
  "note": "Use in Friday's talk",
  "readwise_url": "https://readwise.io/open/503017",
  "tags": [
    "favorite"
  ],
  "text": "Writing is not the outcome of thinking; it is the medium in which thinking takes place.",
  "updated": "2026-10-28T09:00:05Z",
  "url": ""
}
```

### Change Reader document

Move a Reader document to the Inbox, Later or Archive, or change its details, tags or note.

**Inputs**

- Document (`document`, text, required): The document's ID, from 'Save to Reader' or 'List Reader documents', or its Reader link.
- Move to (`location`, text): Where to move it. Leave empty to keep it where it is. One of: `new` (Inbox), `later`, `archive`, `feed`.
- Title (`title`, text): A new title. Leave empty to keep it.
- Author (`author`, text): A new author. Leave empty to keep it.
- Summary (`summary`, text): A new summary. Leave empty to keep it.
- Note (`notes`, text): A new note, replacing the one there. Leave empty to keep it.
- Tags (`tags`, list): Its tags, replacing the ones there. Leave empty to keep them.
- Kind (`category`, text): What it is. Leave empty to keep it. One of: `article`, `email`, `rss` (RSS item), `pdf`, `epub` (EPUB book), `tweet`, `video`.

**Outputs**

- `author` (text): Its author
- `category` (text): article, email, rss, pdf, epub, tweet, video, highlight or note
- `created_at` (text): When it was saved (ISO 8601)
- `id` (text): The document's ID
- `location` (text): new (Inbox), later, shortlist, archive or feed
- `notes` (text): Your note on it
- `parent_id` (text): For a highlight or note, the document it's in
- `reader_url` (text): Its link in Reader
- `reading_progress` (number): How far through it you are, from 0 to 1
- `site_name` (text): The website's name
- `summary` (text): Its summary
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `url` (text): The page it was saved from
- `word_count` (number): How many words it has

**Example output**

```json
{
  "author": "S\u00f6nke Ahrens",
  "category": "article",
  "created_at": "2026-10-28T09:00:00Z",
  "id": "01gwfvp9pyaabcdgmx14f6ha0",
  "location": "later",
  "notes": "Read before Friday",
  "parent_id": "",
  "reader_url": "https://read.readwise.io/read/01gwfvp9pyaabcdgmx14f6ha0",
  "reading_progress": 0.25,
  "site_name": "Example",
  "summary": "Why writing notes as you read pays off.",
  "tags": [
    "notes"
  ],
  "title": "How to take smart notes",
  "updated_at": "2026-10-28T09:05:00Z",
  "url": "https://example.com/smart-notes",
  "word_count": 2400
}
```

### Delete highlight

Delete a highlight. It cannot be undone.

**Inputs**

- Highlight (`highlight`, text, required): The highlight's number, from 'Add highlight' or 'List highlights', or its readwise.io link.

**Outputs**

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

**Example output**

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

### Delete Reader document

Delete a Reader document, with its highlights and notes. It cannot be undone.

**Inputs**

- Document (`document`, text, required): The document's ID, from 'Save to Reader' or 'List Reader documents', or its Reader link.

**Outputs**

- `deleted` (true/false): True once deleted
- `id` (text): The document's ID

**Example output**

```json
{
  "deleted": true,
  "id": "01gwfvp9pyaabcdgmx14f6ha0"
}
```

### Get daily review

Get today's daily review: the highlights Readwise picked for you to look at again.

**Inputs**: None.

**Outputs**

- `completed` (true/false): True once you've done today's review
- `count` (number): How many highlights
- `highlights` (list): The highlights to review
- `review_url` (text): The review's link in Readwise

**Example output**

```json
{
  "completed": false,
  "count": 1,
  "highlights": [
    {
      "author": "S\u00f6nke Ahrens",
      "id": 503017,
      "note": "",
      "source_url": "",
      "text": "Writing is not the outcome of thinking; it is the medium in which thinking takes place.",
      "title": "How to Take Smart Notes"
    }
  ],
  "review_url": "https://readwise.io/reviews/1234"
}
```

### Get highlight

Get one highlight, with its note, colour and tags.

**Inputs**

- Highlight (`highlight`, text, required): The highlight's number, from 'Add highlight' or 'List highlights', or its readwise.io link.

**Outputs**

- `book_id` (number): The book or article it's from
- `color` (text): yellow, blue, pink, orange, green or purple
- `created_at` (text): When it was added to Readwise (ISO 8601)
- `highlighted_at` (text): When it was highlighted (ISO 8601)
- `id` (number): The highlight's number
- `note` (text): Your note on it
- `readwise_url` (text): Its link in Readwise
- `tags` (list): Its tags
- `text` (text): The highlighted words
- `updated` (text): When it last changed (ISO 8601)
- `url` (text): A link to where it is in the source, if any

**Example output**

```json
{
  "book_id": 2608,
  "color": "yellow",
  "created_at": "2026-10-28T09:00:05Z",
  "highlighted_at": "2026-10-28T09:00:00Z",
  "id": 503017,
  "note": "Use in Friday's talk",
  "readwise_url": "https://readwise.io/open/503017",
  "tags": [
    "favorite"
  ],
  "text": "Writing is not the outcome of thinking; it is the medium in which thinking takes place.",
  "updated": "2026-10-28T09:00:05Z",
  "url": ""
}
```

### Get Reader document

Get one Reader document: its title, location, tags, notes and how far you've read.

**Inputs**

- Document (`document`, text, required): The document's ID, from 'Save to Reader' or 'List Reader documents', or its Reader link.

**Outputs**

- `author` (text): Its author
- `category` (text): article, email, rss, pdf, epub, tweet, video, highlight or note
- `created_at` (text): When it was saved (ISO 8601)
- `id` (text): The document's ID
- `location` (text): new (Inbox), later, shortlist, archive or feed
- `notes` (text): Your note on it
- `parent_id` (text): For a highlight or note, the document it's in
- `reader_url` (text): Its link in Reader
- `reading_progress` (number): How far through it you are, from 0 to 1
- `site_name` (text): The website's name
- `summary` (text): Its summary
- `tags` (list): Its tags
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `url` (text): The page it was saved from
- `word_count` (number): How many words it has

**Example output**

```json
{
  "author": "S\u00f6nke Ahrens",
  "category": "article",
  "created_at": "2026-10-28T09:00:00Z",
  "id": "01gwfvp9pyaabcdgmx14f6ha0",
  "location": "later",
  "notes": "Read before Friday",
  "parent_id": "",
  "reader_url": "https://read.readwise.io/read/01gwfvp9pyaabcdgmx14f6ha0",
  "reading_progress": 0.25,
  "site_name": "Example",
  "summary": "Why writing notes as you read pays off.",
  "tags": [
    "notes"
  ],
  "title": "How to take smart notes",
  "updated_at": "2026-10-28T09:05:00Z",
  "url": "https://example.com/smart-notes",
  "word_count": 2400
}
```

### List books

List the books, articles, tweets and podcasts your highlights come from.

**Inputs**

- Kind (`category`, text): Only this kind. Leave empty for all. One of: `books`, `articles`, `tweets`, `podcasts`, `supplementals`.
- Changed after (`updated_after`, date and time): Only books added or changed after this time.
- How many (`limit`, number): How many books. Defaults to 25. From 1 to 1000.

**Outputs**

- `books` (list): The books and articles
- `count` (number): How many books

**Example output**

```json
{
  "books": [
    {
      "author": "S\u00f6nke Ahrens",
      "category": "books",
      "id": 2608,
      "last_highlight_at": "2026-10-28T09:00:00Z",
      "num_highlights": 42,
      "source": "kindle",
      "source_url": "",
      "tags": [],
      "title": "How to Take Smart Notes",
      "updated": "2026-10-28T09:00:05Z"
    }
  ],
  "count": 1
}
```

### List highlights

List highlights, in every book or one, or only those added or changed after a time.

**Inputs**

- Book (`book`, text): Only this book or article's highlights.
- Changed after (`updated_after`, date and time): Only highlights added or changed after this time.
- How many (`limit`, number): How many highlights. Defaults to 25. From 1 to 1000.

**Outputs**

- `count` (number): How many highlights
- `highlights` (list): The highlights

**Example output**

```json
{
  "count": 1,
  "highlights": [
    {
      "book_id": 2608,
      "color": "yellow",
      "created_at": "2026-10-28T09:00:05Z",
      "highlighted_at": "2026-10-28T09:00:00Z",
      "id": 503017,
      "note": "Use in Friday's talk",
      "readwise_url": "https://readwise.io/open/503017",
      "tags": [
        "favorite"
      ],
      "text": "Writing is not the outcome of thinking; it is the medium in which thinking takes place.",
      "updated": "2026-10-28T09:00:05Z",
      "url": ""
    }
  ]
}
```

### List Reader documents

List Reader documents by location, kind or tag, or those changed after a time.

**Inputs**

- Location (`location`, text): Only documents here. Leave empty for everywhere. One of: `new` (Inbox), `later`, `shortlist`, `archive`, `feed`.
- Kind (`category`, text): Only this kind. Leave empty for every kind but highlights and notes. One of: `article`, `email`, `rss` (RSS item), `pdf`, `epub` (EPUB book), `tweet`, `video`, `highlight`, `note`.
- Tag (`tag`, text): Only documents with this tag.
- Changed after (`updated_after`, date and time): Only documents added or changed after this time.
- How many (`limit`, number): How many documents. Defaults to 25. From 1 to 1000.

**Outputs**

- `count` (number): How many documents
- `documents` (list): The documents

**Example output**

```json
{
  "count": 1,
  "documents": [
    {
      "author": "S\u00f6nke Ahrens",
      "category": "article",
      "created_at": "2026-10-28T09:00:00Z",
      "id": "01gwfvp9pyaabcdgmx14f6ha0",
      "location": "later",
      "notes": "Read before Friday",
      "parent_id": "",
      "reader_url": "https://read.readwise.io/read/01gwfvp9pyaabcdgmx14f6ha0",
      "reading_progress": 0.25,
      "site_name": "Example",
      "summary": "Why writing notes as you read pays off.",
      "tags": [
        "notes"
      ],
      "title": "How to take smart notes",
      "updated_at": "2026-10-28T09:05:00Z",
      "url": "https://example.com/smart-notes",
      "word_count": 2400
    }
  ]
}
```

### Save to Reader

Save a link to Reader to read later. Reader fetches the page itself.

**Inputs**

- Link (`url`, text, required): The page's address, starting with https://.
- Title (`title`, text): Its title. Leave empty to use the page's own.
- Author (`author`, text): Its author. Leave empty to use the page's own.
- Summary (`summary`, text): A short summary.
- Note (`notes`, text): Your note on it.
- Tags (`tags`, list): Tags to add.
- Save to (`location`, text): Where in Reader to put it. Defaults to the Inbox. One of: `new` (Inbox), `later`, `archive`, `feed`.
- Kind (`category`, text): What it is. Leave empty for Reader to tell from the page. One of: `article`, `email`, `rss` (RSS item), `pdf`, `epub` (EPUB book), `tweet`, `video`.
- Published (`published_date`, date): When it was published. Leave empty to use the page's own date.

**Outputs**

- `already_saved` (true/false): True if the link was already in Reader
- `id` (text): The document's ID
- `reader_url` (text): Its link in Reader

**Example output**

```json
{
  "already_saved": false,
  "id": "01gwfvp9pyaabcdgmx14f6ha0",
  "reader_url": "https://read.readwise.io/read/01gwfvp9pyaabcdgmx14f6ha0"
}
```

### Tag highlight

Add a tag to a highlight.

**Inputs**

- Highlight (`highlight`, text, required): The highlight's number, from 'Add highlight' or 'List highlights', or its readwise.io link.
- Tag (`tag`, text, required): The tag to add, such as favorite.

**Outputs**

- `highlight_id` (number): The highlight
- `tag` (text): The tag
- `tag_id` (number): The tag's number on it

**Example output**

```json
{
  "highlight_id": 503017,
  "tag": "favorite",
  "tag_id": 77
}
```
