• Documentation >
• Apps >
• Productivity >
• Raindrop.io

Raindrop.io

With the Raindrop.io modules in Ibexa Connect, you can:

• Watch, list, create, retrieve, update and delete the bookmarks.

• Watch, list, create, retrieve, update and delete the collection.

To get started with the Raindrop.io, create an account at raindrop.io

Connect Raindrop.io with Ibexa Connect

To connect the Raindrop.io app with the Ibexa Connect:

1. Log in to your Raindrop.io account.

2. Log in to your Ibexa Connect and add a module from the Raindrop.io into a Ibexa Connect scenario.

3. Click Add next to the Connection field.

   

4. In the Connection name field, enter a name for the connection and click Save.

5. Click Agree to establish the connection.

   

You have successfully connected the Raindrop.io app with Ibexa Connect and can now build scenarios.

Bookmarks

You can watch, list, create, retrieve, update and delete the bookmarks using the following modules.

Watch Bookmarks

Triggers when a new bookmark is created.

Collection	Select or choose a collection whose bookmarks you want to watch.
Filter	Enter (maps) the details to filter: Search Enter (map) the text to search by title, description, tags, URL, and page content. Tags Select or map the tags for the bookmarks you want to match. Favorited Only Select whether to watch only the bookmarks that marked as favourite. Broken Links Only Select whether to include the broken links. Type Select the type: Link Article Image Document Audio Hostname Enter (map) the hostname to watch the bookmarks.
Limit	Set the maximum number of bookmarks Ibexa Connect will return during one execution cycle. The default value is 2.

List Bookmarks

Lists bookmarks.

Collection	Enter (map) the collections' details: Way of Selecting Collections Select the collections: Map a Collection ID Pick a Collection Collection ID Enter the Collection ID whose bookmarks you want to list. Collection Select or choose a collection whose bookmarks you want to list.
Sort by	Select a method to sort: Relevance Date (ascending) Date (descending) Order (descending) Title (ascending) Title (descending) Hostname (ascending) Hostname (descending)
Filter	Enter (maps) the details to filter: Search Enter (map) the text to search the bookmarks by title, description, tags, URL, and page content. Tags Select or map the tags of the bookmarks you want to list. Favorited Only Select whether to list only the favorited bookmarks only. Broken Links Only Select whether to include the broken links in the search results. Type Select or map the bookmark content-type: Link Article Image Document Audio Hostname Enter (map) a name for the host.
Limit	Set the maximum number of bookmarks Ibexa Connect will return during one execution cycle. The default value is 30.

Create a Bookmark

Creates a new bookmark.

Bookmark Type	Select the bookmark type: URL File
URL	Enter (map) the URL address for which you want to create a bookmark.
Prevent Duplicate Links	Select whether to prevent duplicate links for the bookmark.
File	Enter the details of the file: Name Enter (map) a name for the file including the file extension. For example, invoice.xml. Data Enter (map) the data of the file.
Title	Enter (map) the bookmark name.
Description	Enter (map) the bookmark details.
Collection	Enter the details of the collection: Way of Selecting Collections Select the collection: Map a Collection ID Pick a Collection Collection ID Enter the parent Collection ID for this collection. Collection Select or choose parent collection to for this collection.
Tags	Select or map the tags of the bookmark.
Favorite	Select whether to include the bookmark in the favorites.
Cover URLs	Enter (map) the URLs of pictures to be used as covers. The first item will be used as the bookmark's thumbnail.
Order	Enter (map) the sort order (ascending). For example, if you want to move the bookmark to the first place set this field to 0.
Creation Date	Enter the date of creation of the bookmark. See the list of supported date and time formats.

Get a Bookmark

Gets a bookmark.

Bookmark

Enter (map) the details of the bookmark: Way of Selecting Bookmarks Select the bookmarks: Map a Bookmark ID Pick a Bookmark Bookmark ID Enter (map) a Bookmark ID whose details you want to retrieve. Bookmark Select or choose a bookmark whose details you want to retrieve.

Update a Bookmark

Updates a bookmark.

Bookmark	Enter (map) the details of the bookmark: Way of Selecting Bookmarks Select the bookmarks: Map a Bookmark ID Pick a Bookmark Bookmark ID Enter the Bookmark ID whose details you want to update. Bookmark Select or choose a bookmark whose details you want to update.
URL	Enter (map) the updated URL of the bookmark.
Title	Enter (map) a new name for the bookmark.
Description	Enter (map) the bookmark details.
Collection	Enter the details of the collection: Way of Selecting Collections Select the collection: Map a Collection ID Pick a Collection Collection ID Ente the parent Collection ID to which you want to add the bookmark. Collection Select or choose a parent collection to which you want to add the bookmark.
Tags	Select or map the tags for the bookmark.
Favorite	Select whether to include the bookmark in the favorites.
Cover URLs	Enter (map) the image URL address for the bookmark. These are the URLs of pictures to be used as covers. The first item will be used as the bookmark's thumbnail.
Order	Enter the sort order (ascending) for the bookmark. For example, if you want to move the bookmark to the first place set this field to 0

Delete a Bookmark

Deletes a bookmark.

Bookmark

Enter (map) the details of the bookmark: Way of Selecting Bookmarks Select the bookmarks: Map a Bookmark ID Pick a Bookmark Bookmark ID Enter the Bookmark ID you want to delete. Bookmark Choose the bookmark you want to delete.

Collections

You can watch, list, create, update, retrieve, and delete the collections using the following modules.

Watch Collections

Triggers when a new collection is created.

Collections to Watch	Select the collections to watch: Only Root Collections Only Nested Collections Nested in Specific Collections The Nested in Specific Collection option provides auto-populates Parent Collection > Pick a Collection parameter which you need select to watch the collections.
Parent Collection	Select or choose the collections to watch: Pick a Collection Choose the parent collection whose collection you want to watch.
Limit	Set the maximum number of collections Ibexa Connect will return during one execution cycle. The default value is 2.

List Collections

Lists collections.

Collections to List	Select or map the collections to list: Only Root Collections Only Nested Collections Nested in Specific Collection The Nested in Specific Collection option provides auto populates Parent Collection > Way of Selecting Collections parameter which you need select to list the collections.
Parent Collection	Select or choose the parent collection details: Way of Selecting Collections Choose a way to select collections: Map a Collection ID Pick a Collection Collection ID Enter the parent Collection ID to list the collections. Collection Choose the parent collection to list the collections.
Limit	Set the maximum number of collections Ibexa Connect will return during one execution cycle. The default value is 30.

Create a Collection

Creates a collection.

Title	Enter (map) the collection name.
Parent Collection	Enter (map) the details of the parent collection: Way of Selecting Collections Select the collections: Map a Collection ID Pick a Collection Collection ID Enter (map) a Collection ID that is parent for this collection. Collection Choose a collection that is the parent for this collection.
View	Select to view: List Cards Headlines Moodboard
Public	Select whether you want the bookmarks and collections accessible to everyone.
Cover URL	Enter (map) the collection icon's image URL address.
Order	Enter the sort order (descending) to define the position of the collection among all the collections nested within the same parent collection.

Get a Collection

Retrieves a collection.

Collection

Enter (map) the collection details: Way of Selecting Collections Select or map the method to select the collection: Map a Collection ID Pick a Collection Collection ID Enter (map) a Collection ID whose details you want to retrieve. Collection Choose the collection whose details you want to retrieve.

Update a Collection

Updates a collection.

Collection	Enter (map) the details of the collection: Way of Selecting Collections Select the collections: Map a Collection ID Pick a Collection Collection ID Enter the Collection ID whose details you want to update. Collection Choose the collection whose details you want to update.
Title	Enter (map) a new name for the collection.
Parent Collection	Enter (map) the details of the parent collection: Way of Selecting Collections Select the collections: Map a Collection ID Pick a Collection Collection ID Enter the Parent Collection ID. Collection Choose a parent collection.
View	Select or map the collection view: List Cards Headlines Moodboard
Public	Select whether the contained bookmarks and collections will be accessible to anyone.
Cover URL	Enter (map) the collection icon's image URL address.
Order	Enter the order to sort the collections to define the position of the collection among all the collections nested within the same parent collection.
Expanded	Select whether you want to expand the collection's nested collections.

Delete a Collection

Deletes a collection.

Collection

Enter (map) the details of the collection to delete: Way of Selecting Collections Select or map the collections: Map a Collection ID Pick a Collection Collection ID Enter the Collection you want to delete. Collection Add the collection you want to delete.

Other

You can parse an HTML bookmark file and call APIs using the following modules.

Parse HTML Bookmark File

Extracts importable bookmarks from an HTML bookmark file.

File	Enter (map) the details of the file: File Name Enter (map) the file name including the file extension. Data Enter (map) the file data.

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://api.raindrop.io/rest. For example /v1/raindrops/0.

For the list of available endpoints, refer to the Raindrop.io API Documentation.

Method

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - Retrieve Root Collections

The following API call retrieves root collections from your Raindrop.ai account:

URL:

/v1/collections

Method:

GET

Matches of the search can be found in the module's Output under Bundles > Body > items.

In our example, 4 collections were returned: