Raindrop.io
Utilities & PersonalConnect over an access token to manage collections, bookmarks, tags, and text highlights through the Raindrop.io REST API v1, with automatic page metadata parsing on new bookmarks.
What This Integration Enables
The Raindrop.io connector lets agents build and maintain a bookmarking library end to end. Agents read the collection tree, create, update, and delete collections, and empty the Trash. They list, fetch, create, update, and delete bookmarks, create or update many at once, and let Raindrop parse page metadata automatically. They read and manage tags across the account or a single collection, pull highlights across every bookmark or a single one, and read the user profile as a connection check. Some actions read, some write, and a few remove permanently. The connector supplies all of them; the surrounding flow decides what to file automatically and what needs a person first.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Automatic Bookmarking
When a link arrives from another app, the agent calls Create Raindrop into a chosen collection with Parse Metadata enabled, so Raindrop fetches the page and fills in the title, excerpt, and cover on its own. The bookmark lands filed and enriched without anyone pasting it in and picking a collection by hand.
Research Library Export
The agent calls Get Raindrops to pull a collection's bookmarks, then creates a page per bookmark in a research database with titles, excerpts, and tags. The export turns a saved reading list into a structured research base without manual re-entry.
Bulk Organization
For a large intake, the agent calls Create Many Raindrops to add up to a hundred bookmarks at once, then uses Update Many Raindrops to add tags or move them into place. Bulk filing keeps a growing library organized without one-by-one handling.
Human-in-Loop Highlight
Filing a bookmark is routine and reversible; a wrong collection is one edit away from fixed. Emptying the Trash is not, because it permanently deletes every bookmark it holds, and deleting a collection or clearing tags across a shared library changes what other people see. This is [human-in-the-loop](/concepts/human-in-the-loop/) at the boundary between organizing a library and removing from it: before any irreversible or shared-library change, the agent pauses, assembles what will be removed or moved, and routes to a person through their preferred channel. The message is specific: "Emptying Trash will permanently delete 42 bookmarks, and this cannot be undone. Proceed, or leave them?" The agent files and organizes on its own; a person owns every deletion and every change to a shared collection.
Agent Capabilities
20 actionsCollections
7- Get Collections Retrieve all root collections for the account, each with its id, title, bookmark count, view style, and visibility.
- Get Child Collections Retrieve all nested child collections for the account, to combine with Get Collections and reconstruct the full collection tree.
- Get Collection Retrieve a single collection by its id, including title, bookmark count, view style, visibility, cover, and parent reference.
- Create Collection Create a new collection with a title and optional view style, public visibility, and a parent collection to nest it under.
- Update Collection Update an existing collection title, view style, public visibility, or parent. Omitted fields are left unchanged.
- Delete Collection Delete a collection by id. Its bookmarks move to Unsorted rather than being deleted, and any descendant collections are removed as well.
- Empty Trash Permanently empty the Trash collection, deleting all bookmarks it contains. This action cannot be undone.
Raindrops
7- Get Raindrops List bookmarks in a collection with search, sorting, and pagination. Reserved ids select all bookmarks, Unsorted, or Trash. Returns a page of raindrops plus the total count.
- Get Raindrop Retrieve a single bookmark by its id, including link, title, excerpt, note, tags, cover, type, and parent collection.
- Create Raindrop Create a new bookmark from a link with an optional title, excerpt, tags, and target collection. With Parse Metadata enabled, Raindrop fills in the title, excerpt, and cover automatically.
- Update Raindrop Update an existing bookmark link, title, excerpt, tags, collection, or important flag. Omitted fields are left unchanged.
- Delete Raindrop Delete a bookmark by id. It moves to Trash; deleting a bookmark already in Trash removes it permanently.
- Create Many Raindrops Create up to 100 bookmarks in a single request. Each item needs at least a link and may include title, excerpt, tags, and a collection reference.
- Update Many Raindrops Apply a bulk update to bookmarks in a collection, optionally restricted to specific ids. Can add tags, toggle the important flag, or move bookmarks to another collection.
Tags
3- Get Tags Retrieve all tags with usage counts, either across the account or scoped to a single collection.
- Rename Tag Rename a tag, merging it into the new name across the account or within a single collection. Every bookmark using the old tag is updated.
- Remove Tags Remove one or more tags from all bookmarks, across the account or within a single collection. The bookmarks themselves are not deleted.
Highlights
2- Get All Highlights Retrieve all text highlights saved across every bookmark, with pagination. Each highlight includes its text, optional note, color, and the bookmark it belongs to.
- Get Highlights Of Raindrop Retrieve all text highlights saved on a single bookmark, including each highlight text, note, and color.
User
1- Get User Retrieve the authenticated user profile, including id, email, full name, plan, and registration date. Useful as a connection check.
Start building with Raindrop.io
$100 in credits. No card required. Connect in minutes.