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

Operation ID:

AddHighlight

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

Body

HighlightResponse

Archive a bookmark

Operation ID:

ArchiveBookmark

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

Body

BookmarkResponse

Create a folder

Operation ID:

CreateFolder

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

Body

FolderResponse

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

Operation ID:

DeleteBookmark

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

Operation ID:

ListBookmarksArchived

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

Body

BookmarksResponse

Get all liked bookmarks

Operation ID:

ListBookmarksLiked

Get all liked bookmarks

Parameters

Name	Key	Required	Type	Description
readFilter	readFilter		string

Returns

The response model for bookmark searches

Body

BookmarksResponse

Get bookmarks in a folder

Operation ID:

ListBookmarksInFolder

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

Body

BookmarksResponse

Get folders

Operation ID:

ListFolders

Get folders

Returns

The resposne model for folder searches

Body

FoldersResponse

Like a bookmark

Operation ID:

LikeBookmark

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

Body

BookmarkResponse

List highlights

Operation ID:

ListHighlights

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

Body

HighlighstResponse

Mark a bookmark read

Operation ID:

MarkReadBookmark

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

Operation ID:

MarkUnreadBookmark

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

Operation ID:

UnarchiveBookmark

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

Body

BookmarkResponse

Unlike a bookmark

Operation ID:

UnlikeBookmark

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

Body

BookmarkResponse

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

Operation ID:

OnBookmarkAdded

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

Body

BookmarksResponse

When a bookmark is archived

Operation ID:

OnBookmarkArchived

When a bookmark is archived

Returns

The response model for bookmark searches

Body

BookmarksResponse

When a bookmark is liked

Operation ID:

OnBookmarkLiked

When a bookmark is liked

Returns

The response model for bookmark searches

Body

BookmarksResponse

When a bookmark is marked read

Operation ID:

OnBookmarkProgressRead

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

Body

BookmarksResponse

When a bookmark is removed from a folder

Operation ID:

OnBookmarkRemoved

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

Operation ID:

OnFolderCreated

When a folder is created

Returns

The resposne model for folder searches

Body

FoldersResponse

When a highlight is added to a bookmark

Operation ID:

OnHighlightAdded

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

Body

HighlighstResponse

When the read progress of a bookmark is updated

Operation ID:

OnBookmarkProgressUpdated

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

Body

BookmarksResponse

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'.