Share via


Instapaper

Instapaper is a tool for saving web pages to read later. You can create reading lists by organizing pages into folders which can then be accessed from any mobile or web client.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Microsoft
URL Microsoft LogicApps Support
Microsoft Power Automate Support
Microsoft Power Apps Support
Connector Metadata
Publisher Microsoft
Website https://www.instapaper.com/
Privacy policy https://www.instapaper.com/privacy

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Instapaper Username string Instapaper Username True
Instapaper Password securestring Instapaper Password True

Throttling Limits

Name Calls Renewal Period
API calls per connection 30 60 seconds

Actions

Add a highlight to a bookmark

Add a highlight to a bookmark

Archive a bookmark

Archive a bookmark

Create a folder

Create a folder

Delete a bookmark permenantly (warning: can not be undone)

Delete a bookmark permenantly (warning: can not be undone)

Get all archived bookmarks

Get all archived bookmarks

Get all liked bookmarks

Get all liked bookmarks

Get bookmarks in a folder

Get bookmarks in a folder

Get folders

Get folders

Like a bookmark

Like a bookmark

List highlights

List the highlights from a specific bookmark.

Mark a bookmark read

Mark a bookmark read

Mark a bookmark unread

Mark a bookmark unread

Unarchive a bookmark

Unarchive a bookmark

Unlike a bookmark

Unlike a bookmark

Add a highlight to a bookmark

Add a highlight to a bookmark

Parameters

Name Key Required Type Description
Bookmark Id
bookmark_id True string

The id of the bookmark

Text
text True string

The text to highlight

Returns

The response model for highlight actions

Archive a bookmark

Archive a bookmark

Parameters

Name Key Required Type Description
Bookmark Id
bookmark_id True string

The id of the bookmark

Returns

The response model for bookark actions

Create a folder

Create a folder

Parameters

Name Key Required Type Description
Name
title True string

The name of the new folder, must be unique

Returns

The resposne model for folder searches

Delete a bookmark permenantly (warning: can not be undone)

Delete a bookmark permenantly (warning: can not be undone)

Parameters

Name Key Required Type Description
Bookmark Id
bookmark_id True string

The id of the bookmark

Returns

response
object

Get all archived bookmarks

Get all archived bookmarks

Parameters

Name Key Required Type Description
Liked filter (default: all)
likedFilter string

Whether to filter on the "liked" feature of a bookmark

Read filter (default: all)
readFilter string

Whether to filter on the read progress of a bookmark

Returns

The response model for bookmark searches

Get all liked bookmarks

Get all liked bookmarks

Parameters

Name Key Required Type Description
readFilter
readFilter string

Returns

The response model for bookmark searches

Get bookmarks in a folder

Get bookmarks in a folder

Parameters

Name Key Required Type Description
Folder
folder_id True string

The folder id, or "unread" for the home folder

Liked filter (default: all)
likedFilter string

Whether to filter on the "liked" feature of a bookmark

Read filter (default: all)
readFilter string

Whether to filter on the read progress of a bookmark

Returns

The response model for bookmark searches

Get folders

Get folders

Returns

The resposne model for folder searches

Like a bookmark

Like a bookmark

Parameters

Name Key Required Type Description
Bookmark Id
bookmark_id True string

The id of the bookmark

Returns

The response model for bookark actions

List highlights

List the highlights from a specific bookmark.

Parameters

Name Key Required Type Description
Bookmark Id
bookmark_id True string

The id of the bookmark

Returns

The response model for highlights actions

Mark a bookmark read

Mark a bookmark read

Parameters

Name Key Required Type Description
Bookmark Id
bookmark_id True string

The id of the bookmark

Returns

response
object

Mark a bookmark unread

Mark a bookmark unread

Parameters

Name Key Required Type Description
Bookmark Id
bookmark_id True string

The id of the bookmark

Returns

response
object

Unarchive a bookmark

Unarchive a bookmark

Parameters

Name Key Required Type Description
Bookmark Id
bookmark_id True string

The id of the bookmark

Returns

The response model for bookark actions

Unlike a bookmark

Unlike a bookmark

Parameters

Name Key Required Type Description
Bookmark Id
bookmark_id True string

The id of the bookmark

Returns

The response model for bookark actions

Triggers

When a bookmark is added to a folder

When a bookmark is added to a folder

When a bookmark is archived

When a bookmark is archived

When a bookmark is liked

When a bookmark is liked

When a bookmark is marked read

When a bookmark is marked read

When a bookmark is removed from a folder

When a bookmark is removed from a folder

When a folder is created

When a folder is created

When a highlight is added to a bookmark

When a highlight is added to a bookmark

When the read progress of a bookmark is updated

When the read progress of a bookmark is updated

When a bookmark is added to a folder

When a bookmark is added to a folder

Parameters

Name Key Required Type Description
Folder
folder_id True string

The folder id, or "unread" for the home folder

Returns

The response model for bookmark searches

When a bookmark is archived

When a bookmark is archived

Returns

The response model for bookmark searches

When a bookmark is liked

When a bookmark is liked

Returns

The response model for bookmark searches

When a bookmark is marked read

When a bookmark is marked read

Parameters

Name Key Required Type Description
Folder
folder_id True string

The folder id, or "unread" for the home folder

Returns

The response model for bookmark searches

When a bookmark is removed from a folder

When a bookmark is removed from a folder

Parameters

Name Key Required Type Description
Folder
folder_id True string

The folder id, or "unread" for the home folder

Returns

response
integer

When a folder is created

When a folder is created

Returns

The resposne model for folder searches

When a highlight is added to a bookmark

When a highlight is added to a bookmark

Parameters

Name Key Required Type Description
Folder
folder_id True string

The folder to look a bookmark up in

Bookmark
bookmark_id True string

The bookmark to check for highlights

Returns

The response model for highlights actions

When the read progress of a bookmark is updated

When the read progress of a bookmark is updated

Parameters

Name Key Required Type Description
Folder
folder_id True string

The folder id, or "unread" for the home folder

Returns

The response model for bookmark searches

Definitions

BookmarksResponse

The response model for bookmark searches

Name Path Type Description
Bookmarks
Bookmarks array of Bookmark

A list of bookmarks returned by the action

Bookmark

A user

Name Path Type Description
Bookmark Id
bookmark_id integer

Identifier of the bookmark

Title
title string

Title of the bookmark

Description
description string
Url
url string

The original url of the bookmarked item

Liked
starred boolean

Indicates whether the bookmark has been liked or not

Creation time
time date-time

The time the bookmark was created

Read progress
progress double

The percentage of the bookmark that has been read

FoldersResponse

The resposne model for folder searches

Name Path Type Description
Folders
Folders array of Folder

A list of folders returned by the action

Folder

A user

Name Path Type Description
Folder Id
folder_id integer

Identifier of the folder

Title
title string
Display title
display_title string
Sync to mobile
sync_to_mobile boolean

indicates whether this folder is synced to mobile app

Position
position integer

Ordinal position of the folder

HighlighstResponse

The response model for highlights actions

Name Path Type Description
Highlights
Highlights array of Highlight

The highlights

Highlight

A user

Name Path Type Description
Highlight Id
highlight_id integer
Text
text string

The text to highlight

Position
position integer

Position where to start searching for the text

Creation time
time date-time

Time the highlight was created

BookmarkResponse

The response model for bookark actions

Name Path Type Description
Bookmark
Bookmark Bookmark

A user

HighlightResponse

The response model for highlight actions

Name Path Type Description
Highlight
Highlight Highlight

A user

FolderResponse

The resposne model for folder searches

Name Path Type Description
Folders
Folders Folder

A user

object

This is the type 'object'.

integer

This is the basic data type 'integer'.