# Raindrop.io

> Save and organise bookmarks in Raindrop.io: save pages with tags and notes, find and update bookmarks, add highlights and manage collections. Start a workflow when a bookmark is saved.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/raindrop

## Actions

### Add highlight

Highlight a passage on a bookmark, with a note and colour.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark's number, from 'Save bookmark' or 'Find bookmarks'.
- Passage (`text`, text, required): The words to highlight.
- Note (`note`, text): Your note on the passage.
- Colour (`color`, text): The highlight's colour. Defaults to yellow. One of: `yellow`, `blue`, `brown`, `cyan`, `gray`, `green`, `indigo`, `orange`, `pink`, `purple`, `red`, `teal`. Default: `yellow`.

**Outputs**

- `bookmark_id` (number): The bookmark it is on
- `color` (text): Its colour, such as yellow
- `created` (text): When it was made (ISO 8601)
- `highlights` (number): How many highlights the bookmark has now
- `id` (text): The highlight's ID
- `note` (text): The note on it
- `text` (text): The highlighted passage

**Example output**

```json
{
  "bookmark_id": 873520114,
  "color": "yellow",
  "created": "2026-10-27T10:05:00.000Z",
  "highlights": 1,
  "id": "62388e9e48b63606f41e44a6",
  "note": "Quote for the newsletter",
  "text": "Small teams ship faster."
}
```

### Change bookmark

Change a bookmark's title, note, tags or collection, or mark it a favorite.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark's number, from 'Save bookmark' or 'Find bookmarks'.
- Collection (`collection`, text): Move it to this collection. Leave empty to keep it.
- Tags (`tags`, list): Its tags, replacing the ones it has. Leave empty to keep them.
- Title (`title`, text): Its title. Leave empty to keep it.
- Note (`note`, text): Your own note on it. Leave empty to keep it.
- Description (`excerpt`, text): A short description of the page. Leave empty to keep it.
- Favorite (`favorite`, true/false): Mark it as a favorite.
- Link (`link`, text): A new address for it. Leave empty to keep it.

**Outputs**

- `broken` (true/false): True when the page can no longer be reached
- `collection_id` (number): The collection it is in (-1 is Unsorted)
- `cover` (text): Its cover image's address
- `created` (text): When it was saved (ISO 8601)
- `domain` (text): The website it is on
- `excerpt` (text): Its description
- `favorite` (true/false): True when it is a favorite
- `highlights` (list): Its highlights
- `id` (number): The bookmark's number
- `link` (text): The page's address
- `note` (text): Your note on it
- `tags` (list): Its tags
- `title` (text): Its title
- `type` (text): link, article, image, video, document or audio
- `updated` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "broken": false,
  "collection_id": 51402213,
  "cover": "https://example.com/cover.png",
  "created": "2026-10-27T10:00:00.000Z",
  "domain": "example.com",
  "excerpt": "Notes from ten years of shipping software.",
  "favorite": false,
  "highlights": [
    {
      "color": "yellow",
      "created": "2026-10-27T10:05:00.000Z",
      "id": "62388e9e48b63606f41e44a6",
      "note": "Quote for the newsletter",
      "text": "Small teams ship faster."
    }
  ],
  "id": 873520114,
  "link": "https://example.com/articles/small-teams",
  "note": "Share with the team",
  "tags": [
    "reading",
    "teams"
  ],
  "title": "Why small teams ship faster",
  "type": "article",
  "updated": "2026-10-27T10:05:00.000Z"
}
```

### Check if saved

Check whether a page is already saved, before saving it twice.

**Inputs**

- Link (`link`, text, required): The page's address.

**Outputs**

- `bookmark_ids` (list): The bookmarks it is saved as
- `link` (text): The address checked
- `saved` (true/false): True when it is already saved

**Example output**

```json
{
  "bookmark_ids": [
    873520114
  ],
  "link": "https://example.com/articles/small-teams",
  "saved": true
}
```

### Create collection

Create a collection, at the top or inside another.

**Inputs**

- Name (`title`, text, required): The collection's name.
- Inside (`parent`, text): Put it inside this collection. Leave empty for the top.
- Public (`public`, true/false): Let anyone with its link see it. Off by default. Default: `false`.

**Outputs**

- `count` (number): How many bookmarks it holds
- `id` (number): The collection's number
- `parent_id` (number): The collection it is inside; empty at the top
- `path` (text): Its place among the others, such as Work / Reading
- `public` (true/false): True when anyone with its link can see it
- `title` (text): Its name

**Example output**

```json
{
  "count": 0,
  "id": 51402213,
  "parent_id": 51402210,
  "path": "Reading",
  "public": false,
  "title": "Reading"
}
```

### Delete bookmark

Move a bookmark to Trash, which Raindrop.io empties itself.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark's number, from 'Save bookmark' or 'Find bookmarks'.

**Outputs**

- `deleted` (true/false): True once moved to Trash
- `id` (number): The bookmark's number

**Example output**

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

### Delete collection

Delete a collection; the bookmarks in it move to Trash.

**Inputs**

- Collection (`collection`, text, required): The collection to delete.

**Outputs**

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

**Example output**

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

### Find bookmarks

Find bookmarks in a collection or everywhere, by words, tags or type, newest first.

**Inputs**

- Collection (`collection`, text): Where to look. Defaults to every collection.
- Search (`search`, text): What to look for, as in Raindrop.io's search box: words, #tag, type:article or created:>2026-01-01.
- Order (`sort`, text): How to order them. Defaults to newest first. One of: `-created` (Newest first), `created` (Oldest first), `score` (Best match (with a search)), `title` (Title, A to Z), `-title` (Title, Z to A), `domain` (Website, A to Z). Default: `-created`.
- Include collections inside it (`include_subcollections`, true/false): Also look in the collections inside the one picked.
- How many (`limit`, number): How many bookmarks. Defaults to 25. From 1 to 500.

**Outputs**

- `bookmarks` (list): The bookmarks found
- `count` (number): How many were returned
- `total` (number): How many match in all

**Example output**

```json
{
  "bookmarks": [
    {
      "broken": false,
      "collection_id": 51402213,
      "cover": "https://example.com/cover.png",
      "created": "2026-10-27T10:00:00.000Z",
      "domain": "example.com",
      "excerpt": "Notes from ten years of shipping software.",
      "favorite": false,
      "highlights": [
        {
          "color": "yellow",
          "created": "2026-10-27T10:05:00.000Z",
          "id": "62388e9e48b63606f41e44a6",
          "note": "Quote for the newsletter",
          "text": "Small teams ship faster."
        }
      ],
      "id": 873520114,
      "link": "https://example.com/articles/small-teams",
      "note": "Share with the team",
      "tags": [
        "reading",
        "teams"
      ],
      "title": "Why small teams ship faster",
      "type": "article",
      "updated": "2026-10-27T10:05:00.000Z"
    }
  ],
  "count": 1,
  "total": 1
}
```

### Get bookmark

Get one bookmark with its note, tags and highlights.

**Inputs**

- Bookmark (`bookmark`, text, required): The bookmark's number, from 'Save bookmark' or 'Find bookmarks'.

**Outputs**

- `broken` (true/false): True when the page can no longer be reached
- `collection_id` (number): The collection it is in (-1 is Unsorted)
- `cover` (text): Its cover image's address
- `created` (text): When it was saved (ISO 8601)
- `domain` (text): The website it is on
- `excerpt` (text): Its description
- `favorite` (true/false): True when it is a favorite
- `highlights` (list): Its highlights
- `id` (number): The bookmark's number
- `link` (text): The page's address
- `note` (text): Your note on it
- `tags` (list): Its tags
- `title` (text): Its title
- `type` (text): link, article, image, video, document or audio
- `updated` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "broken": false,
  "collection_id": 51402213,
  "cover": "https://example.com/cover.png",
  "created": "2026-10-27T10:00:00.000Z",
  "domain": "example.com",
  "excerpt": "Notes from ten years of shipping software.",
  "favorite": false,
  "highlights": [
    {
      "color": "yellow",
      "created": "2026-10-27T10:05:00.000Z",
      "id": "62388e9e48b63606f41e44a6",
      "note": "Quote for the newsletter",
      "text": "Small teams ship faster."
    }
  ],
  "id": 873520114,
  "link": "https://example.com/articles/small-teams",
  "note": "Share with the team",
  "tags": [
    "reading",
    "teams"
  ],
  "title": "Why small teams ship faster",
  "type": "article",
  "updated": "2026-10-27T10:05:00.000Z"
}
```

### List collections

List every collection with how many bookmarks it holds.

**Inputs**: None.

**Outputs**

- `collections` (list): The collections, in order
- `count` (number): How many collections

**Example output**

```json
{
  "collections": [
    {
      "count": 12,
      "id": 51402213,
      "parent_id": 51402210,
      "path": "Work / Reading",
      "public": false,
      "title": "Reading"
    }
  ],
  "count": 1
}
```

### List highlights

List highlights, newest first, from every bookmark or one collection.

**Inputs**

- Collection (`collection`, text): Only highlights from this collection. Leave empty for all.
- How many (`limit`, number): How many highlights. Defaults to 25. From 1 to 500.

**Outputs**

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

**Example output**

```json
{
  "count": 1,
  "highlights": [
    {
      "bookmark_id": 873520114,
      "color": "yellow",
      "created": "2026-10-27T10:05:00.000Z",
      "id": "62388e9e48b63606f41e44a6",
      "link": "https://example.com/articles/small-teams",
      "note": "Quote for the newsletter",
      "tags": [
        "reading",
        "teams"
      ],
      "text": "Small teams ship faster.",
      "title": "Why small teams ship faster"
    }
  ]
}
```

### List tags

List the tags in use, most used first, everywhere or in one collection.

**Inputs**

- Collection (`collection`, text): Only tags in this collection. Leave empty for all.

**Outputs**

- `count` (number): How many tags
- `tags` (list): The tags, most used first

**Example output**

```json
{
  "count": 1,
  "tags": [
    {
      "count": 12,
      "name": "reading"
    }
  ]
}
```

### Save bookmark

Save a page to Raindrop.io, with its title, cover and description filled in.

**Inputs**

- Link (`link`, text, required): The page's address, starting with https://.
- Collection (`collection`, text): Where to save it. Defaults to Unsorted.
- Tags (`tags`, list): Tags to add; a new name makes a new tag.
- Title (`title`, text): Its title. Leave empty to use the page's own.
- Note (`note`, text): Your own note on it. Leave empty to use the page's own.
- Description (`excerpt`, text): A short description of the page. Leave empty to use the page's own.
- Favorite (`favorite`, true/false): Mark it as a favorite.
- Fill in details (`fill_in_details`, true/false): Let Raindrop.io read the page for its title, cover and description. On by default. Default: `true`.

**Outputs**

- `broken` (true/false): True when the page can no longer be reached
- `collection_id` (number): The collection it is in (-1 is Unsorted)
- `cover` (text): Its cover image's address
- `created` (text): When it was saved (ISO 8601)
- `domain` (text): The website it is on
- `excerpt` (text): Its description
- `favorite` (true/false): True when it is a favorite
- `highlights` (list): Its highlights
- `id` (number): The bookmark's number
- `link` (text): The page's address
- `note` (text): Your note on it
- `tags` (list): Its tags
- `title` (text): Its title
- `type` (text): link, article, image, video, document or audio
- `updated` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "broken": false,
  "collection_id": 51402213,
  "cover": "https://example.com/cover.png",
  "created": "2026-10-27T10:00:00.000Z",
  "domain": "example.com",
  "excerpt": "Notes from ten years of shipping software.",
  "favorite": false,
  "highlights": [],
  "id": 873520114,
  "link": "https://example.com/articles/small-teams",
  "note": "Share with the team",
  "tags": [
    "reading",
    "teams"
  ],
  "title": "Why small teams ship faster",
  "type": "article",
  "updated": "2026-10-27T10:05:00.000Z"
}
```
