--- title: "Raindrop.io Integration" description: "Connect 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." url: https://flowrunner.ai/integrations/raindrop date_modified: 2026-08-07T17:20:23-07:00 --- # Raindrop.io [Utilities & Personal](https://flowrunner.ai/integrations/category/utilities-personal) Connect 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. [Verified](https://flowrunner.ai/integrations/verified "What does verified mean?") · 20 actions · API key · available [Raindrop.io website](https://raindrop.io/) · [Platform Documentation](https://developer.raindrop.io/) · Capability data verified 2026-07-14 1. A link arrives from another app that should be bookmarked 2. Agent reads the URL and any title or tags provided 3. Agent calls Create Raindrop into the target collection with Parse Metadata on 4. Agent confirms Raindrop parsed the title, excerpt, and cover 5. Agent checks the collection and tags against the filing convention 6. Agent logs the new bookmark for a periodic review 7. A person approves any destructive cleanup before it runs ## 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 **Links filed by hand**: Someone pastes each URL into Raindrop and picks a collection **Metadata entered manually**: Titles and excerpts get typed in one bookmark at a time **Cleanup is risky**: Emptying Trash or deleting a collection is done by hand, with no second look ### With FlowRunner **Links filed in the flow**: The agent creates each bookmark in the right collection automatically **Metadata parsed automatically**: Parse Metadata fills in title, excerpt, and cover on the way in **Cleanup gated**: Irreversible actions pause for approval before anything is removed ## 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](https://flowrunner.ai/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 processes routinely Detects exception requiring judgment Clear match Continues automatically Ambiguous Routes to human via preferred channel Human decides Agent resumes with decision ## Agent Capabilities 20 actions ### Collections 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. ## Frequently Asked Questions ### What can FlowRunner do with Raindrop.io? FlowRunner agents can run Get Collections, Get Child Collections, and Get Collection in Raindrop.io, plus 17 more actions. ### Does connecting Raindrop.io to FlowRunner require OAuth? No. Raindrop.io connects to FlowRunner with an API key, no OAuth flow required. ### Can Raindrop.io trigger a FlowRunner workflow automatically? Raindrop.io doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger. **Work at Raindrop.io?** This integration exposes Raindrop.io to AI agents on every FlowRunner plan, including through MCP, at no cost to you. [See what FlowRunner offers integration partners](https://flowrunner.ai/integrations/partners), including how to keep this page current. --- Markdown version of https://flowrunner.ai/integrations/raindrop. Site index: https://flowrunner.ai/llms.txt