Поделиться через

Readwise (Independent Publisher) (Preview)

  • Reference

Readwise helps thousands of readers get the most out of their digital highlights. Sync your highlights from Kindle, Instapaper, Pocket, iBooks, and more. Review the best parts easily through a daily email & app.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Troy Taylor
URL https://www.hitachisolutions.com
Email [email protected]
Connector Metadata
Publisher Troy Taylor
Website https://readwise.io/
Privacy policy https://readwise.io/privacy
Categories Lifestyle and Entertainment;Productivity

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
Access Token (in the format 'Token YourAccessToken') securestring The Access Token (in the format 'Token YourAccessToken') for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Create a book's tag

Creates a new tag for a book.
Create a highlight

Saves a highlight to your Readwise account.
Create a highlight's tag

Create a new tag on a hightlight.
Delete a book's tag

Deletes a tag for a book.
Delete a highlight

Deletes a specific hightlight.
Delete a highlight's tag

Deletes a tag on a highlight.
Get a book

Retrieve the details for a specific book.
Get a book's tags

Retrieve a list of tags for a book.
Get books

Retrieve a list of saved books.
Get highlight's tags

Retrieve a list of a highlight's tags.
Get highlight details

Retrieves the details of a specific highlight
Get highlights

Export a list of highlights save to your Readwise account.
Get specific highlights

Export a specific list of highlights save to your Readwise account.
Update a book's tag

Updates a tag for a book.
Update a highlight

Update an existing highlight.
Update a highlight's tag

Updates a tag's name for a hightlight.

Create a book's tag

Operation ID:
BookTagsCreate

Creates a new tag for a book.

Parameters

Name Key Required Type Description
Book ID
 book id True string

The book identifier.
Name
 name True string

The name.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Name
 name string

The name.

Create a highlight

Operation ID:
HighlightSavePost

Saves a highlight to your Readwise account.

Parameters

Name Key Required Type Description
Text
 text True string

The text.
Title
 title string

The title.
Author
 author string

The author.
Source URL
 source_url string

The source URL address.
Source Type
 source_type string

The source type.
Category
 category string

The category.
Note
 note string

The note.
Location
 location integer

The location.
Location Type
 location_type string

The location type.
Highlighted At
 highlighted_at string

The highlighted at time.
Highlight URL
 highlight_url string

The highlight URL address.

Returns

Name Path Type Description
array of object
ID
 id integer

The identifier.
Title
 title string

The title.
Author
 author string

The author.
Category
 category string

The category.
Source
 source string

The source.
Num Highlights
 num_highlights integer

The number of highlights.
Last Highlight At
 last_highlight_at string

When last highlighted at.
Updated
 updated string

When updated.
Cover Image URL
 cover_image_url string

The cover image URL address.
Highlights URL
 highlights_url string

The highlights URL address.
Source URL
 source_url string

The source URL address.
ASIN
 asin string

The ASIN.
Tags
 tags array of object
ID
 tags.id integer

The identifier.
Name
 tags.name string

The name.
Modified Highlights
 modified_highlights array of integer

The modified highlights.

Create a highlight's tag

Operation ID:
HighlightTagsPost

Create a new tag on a hightlight.

Parameters

Name Key Required Type Description
Highlight ID
 highlight id True string

The highlight identifier.
Name
 name True string

The name.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Name
 name string

The name.

Delete a book's tag

Operation ID:
BookTagsDelete

Deletes a tag for a book.

Parameters

Name Key Required Type Description
Book ID
 book id True string

The book identifier.
Tag ID
 tag id True string

The tag identifier.

Returns

response
string

Delete a highlight

Operation ID:
HighlightDelete

Deletes a specific hightlight.

Parameters

Name Key Required Type Description
Highlight ID
 highlight id True string

The highlight identifier.

Returns

response
string

Delete a highlight's tag

Operation ID:
HighlightTagsDelete

Deletes a tag on a highlight.

Parameters

Name Key Required Type Description
Highlight ID
 highlight id True string

The highlight identifier.
Tag ID
 tag id True string

The tag identifier.

Returns

response
string

Get a book

Operation ID:
BookGet

Retrieve the details for a specific book.

Parameters

Name Key Required Type Description
Book ID
 book id True string

The book identifier.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Title
 title string

The title.
Author
 author string

The author.
Category
 category string

The category.
Source
 source string

The source.
Num Highlights
 num_highlights integer

The number of highlights.
Last Highlight At
 last_highlight_at string

When last highlighted at.
Updated
 updated string

When updated.
Cover Image URL
 cover_image_url string

The cover image URL address.
Highlights URL
 highlights_url string

The highlights URL address.
Source URL
 source_url string

The source URL address.
ASIN
 asin string

The ASIN.
Tags
 tags array of object
ID
 tags.id integer

The identifier.
Name
 tags.name string

The name.

Get a book's tags

Operation ID:
BookTagsGet

Retrieve a list of tags for a book.

Parameters

Name Key Required Type Description
Book ID
 book id True string

The book identifier.
Page Size
 page_size integer

The page size.
Page
 page string

The page.

Returns

Name Path Type Description
Count
 count integer

The count.
Next
 next string

The next page address.
Previous
 previous string

The previous page address.
Results
 results array of object
ID
 results.id integer

The identifier.
Name
 results.name string

The name.

Get books

Operation ID:
BookListGet

Retrieve a list of saved books.

Parameters

Name Key Required Type Description
Page Size
 page_size integer

The page size.
Page
 page string

The page.
Category
 category string

The category.
Source
 source string

The source.
Num Highlights
 num_highlights integer

The number of highlights.
Num Highlights Less Than
 num_highlights__lt integer

The number of highlights less than.
Num Highlights Greater Than
 num_highlights__gt integer

The number of highlights greater than.
Updated Less Than
 updated__lt string

The updated before time.
Updated Greater Than
 updated__gt string

The updated after time.
Last Highlight At Less Than
 last_highlight_at__lt string

The last highlight at before time.
Last Highlight At Greater Than
 last_highlight_gt string

The last highlight high after time.

Returns

Name Path Type Description
Count
 count integer

The count.
Next
 next string

The next page address.
Previous
 previous string

The previous page address.
Results
 results array of object
ID
 results.id integer

The identifier.
Title
 results.title string

The title.
Author
 results.author string

The author.
Category
 results.category string

The category.
Source
 results.source string

The source.
Num Highlights
 results.num_highlights integer

The number of highlights.
Last Highlight At
 results.last_highlight_at string

When last highlighted at.
Updated
 results.updated string

When updated.
Cover Image URL
 results.cover_image_url string

The cover image URL address.
Highlights URL
 results.highlights_url string

The highlights URL address.
Source URL
 results.source_url string

The source URL address.
ASIN
 results.asin string

The ASIN.
Tags
 results.tags array of object
ID
 results.tags.id integer

The identifier.
Name
 results.tags.name string

The name.

Get highlight's tags

Operation ID:
HighlightTagsGet

Retrieve a list of a highlight's tags.

Parameters

Name Key Required Type Description
Highlight ID
 highlight id True string

The highlight identifier.
Page Size
 page_size integer

The page size.
Page
 page string

The page.

Returns

Name Path Type Description
Count
 count integer

The count.
Next
 next string

The next page address.
Previous
 previous string

The previous page address.
Results
 results array of object
ID
 results.id integer

The identifier.
Name
 results.name string

The name.

Get highlight details

Operation ID:
HightlightDetailGet

Retrieves the details of a specific highlight

Parameters

Name Key Required Type Description
Highlight ID
 highlight id True string

The highlight identifier.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Text
 text string

The text.
Location
 location integer

The location.
Location Type
 location_type string

The location type.
Note
 note string

The note.
Color
 color string

The color.
Highlighted At
 highlighted_at string

When highlighted at.
Created At
 created_at string

When created at.
Updated At
 updated_at string

When updated at.
External ID
 external_id string

The external identifier.
End Location
 end_location string

The end location.
URL
 url string

The URL address.
Book ID
 book_id integer

The book identifier.
Tags
 tags array of object
ID
 tags.id integer

The identifier.
Name
 tags.name string

The name.
Is Favorite
 is_favorite boolean

Whether is favorite.
Is Discard
 is_discard boolean

Whether is discarded.
Readwise URL
 readwise_url string

The Readwise URL address.

Get highlights

Operation ID:
HighlightExportGet

Export a list of highlights save to your Readwise account.

Parameters

Name Key Required Type Description
Updated After
 updatedAfter string

The updated after time.
IDs
 ids string

The identifiers.
Page Cursor
 pageCursor string

The page cursor.

Returns

Name Path Type Description
Count
 count integer

The count.
Next Page Cursor
 nextPageCursor string

The next page cursor.
Results
 results array of object
User Book ID
 results.user_book_id integer

The user book identifier.
Title
 results.title string

The title.
Author
 results.author string

The author.
Readable Title
 results.readable_title string

The readable title.
Source
 results.source string

The source.
Cover Image URL
 results.cover_image_url string

The cover image URL address.
Unique URL
 results.unique_url string

The unique URL address.
Book Tags
 results.book_tags array of string

The book tags.
Category
 results.category string

The category.
Readwise URL
 results.readwise_url string

The Readwise URL address.
Source URL
 results.source_url string

The source URL address.
ASIN
 results.asin string

The ASIN.
Highlights
 results.highlights array of object
ID
 results.highlights.id integer

The identifier.
Text
 results.highlights.text string

The text.
Location
 results.highlights.location integer

The location.
Location Type
 results.highlights.location_type string

The location type.
Note
 results.highlights.note string

The note.
Color
 results.highlights.color string

The color.
Highlighted At
 results.highlights.highlighted_at string

When highlighted at.
Created At
 results.highlights.created_at string

When created at.
Updated At
 results.highlights.updated_at string

When updated at.
External ID
 results.highlights.external_id string

The external identifier.
End Location
 results.highlights.end_location string

The end location.
URL
 results.highlights.url string

The URL address.
Book ID
 results.highlights.book_id integer

The book identifier.
tags
 results.highlights.tags array of string

The tags.
Is Favorite
 results.highlights.is_favorite boolean

Whether is favorite.
Is Discard
 results.highlights.is_discard boolean

Whether is discarded.
Readwise URL
 results.highlights.readwise_url string

The Readwise URL address.

Get specific highlights

Operation ID:
HighlightListGet

Export a specific list of highlights save to your Readwise account.

Parameters

Name Key Required Type Description
Page Size
 page_size integer

The page size.
Page
 page integer

The page.
Book ID
 book_id integer

The book identifier.
Updated Less Than
 updated__lt string

The updated before time.
Updated Greater Than
 updated__gt string

The updated after time.
Highlighted Less Than
 hightlighted_at__lt string

The highlighted before time.
Highlighted Greater Than
 highlighted_at__gt string

The highlighted after time.

Returns

Name Path Type Description
Count
 count integer

The count.
Next
 next string

The next page address.
Previous
 previous string

The previous page address.
Results
 results array of object
ID
 results.id integer

The identifier.
Text
 results.text string

The text.
Note
 results.note string

The note.
Location
 results.location integer

The location.
Location Type
 results.location_type string

The location type.
Highlighted At
 results.highlighted_at string

The highlighted at time.
URL
 results.url string

The URL address.
Color
 results.color string

The tag color.
Updated
 results.updated string

When updated.
Book ID
 results.book_id integer

The book identifier.
Tags
 results.tags array of object
ID
 results.tags.id integer

The identifier.
Name
 results.tags.name string

The name.

Update a book's tag

Operation ID:
BookTagsUpdate

Updates a tag for a book.

Parameters

Name Key Required Type Description
Book ID
 book id True string

The book identifier.
Tag ID
 tag id True string

The tag identifier.
Name
 name True string

The name.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Name
 name string

The name.

Update a highlight

Operation ID:
HighlightUpdatePatch

Update an existing highlight.

Parameters

Name Key Required Type Description
Highlight ID
 highlight id True string

The highlight identifier.
Text
 text string

The text.
Note
 note string

The note.
Location
 location integer

The location.
URL
 url string

The URL address.
Color
 color string

The color.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Text
 text string

The text.
Location
 location integer

The location.
Location Type
 location_type string

The location type.
Note
 note string

The note.
Color
 color string

The color.
Highlighted At
 highlighted_at string

When highlighted at.
Created At
 created_at string

When created at.
Updated At
 updated_at string

When updated at.
External ID
 external_id string

The external identifier.
End Location
 end_location string

The end location.
URL
 url string

The URL address.
Book ID
 book_id integer

The book identifier.
Tags
 tags array of object
ID
 tags.id integer

The identifier.
Name
 tags.name string

The name.
Is Favorite
 is_favorite boolean

Whether is favorite.
Is Discard
 is_discard boolean

Whether is discarded.
Readwise URL
 readwise_url string

The Readwise URL address.

Update a highlight's tag

Operation ID:
HighlightTagsUpdate

Updates a tag's name for a hightlight.

Parameters

Name Key Required Type Description
Highlight ID
 highlight id True string

The highlight identifier.
Tag ID
 tag id True string

The tag identifier.
Name
 name True string

The name.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Name
 name string

The name.

Definitions

string

This is the basic data type 'string'.