Highlight a passage
Highlight a passage of text in a saved article.
POST https://cotlet.dev/api/v1/instapaper/bookmarks/{bookmark_id}/highlights
write
Highlights the text you pass inside one article and returns the highlight. Pass position to pick which occurrence when the text appears more than once; 0 is the first. Free accounts can create 5 highlights a month; past that the call fails. Reaches no one and is undone by deleting the highlight in Instapaper, so it runs without asking.
Parameters
| Name | Type | Description |
|---|---|---|
| bookmark_id integer required | integer | Bookmark ID from list_bookmarks. |
| text string required | string | The exact passage from the article. |
| position integer | integer | Which occurrence of the text to highlight, counting from 0. Default: 0. |
Request
curl -X POST https://cotlet.dev/api/v1/instapaper/bookmarks/1/highlights \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"text"}'result = client.call("instapaper", "create_highlight", {"bookmark_id":1,"text":"text"})const result = await cotlet.call('instapaper', 'create_highlight', {"bookmark_id":1,"text":"text"});cotlet call instapaper create_highlight --data '{"bookmark_id":1,"text":"text"}'Example response
{
"highlight_id": 77120502,
"bookmark_id": 1893240551,
"text": "Salt the water until it tastes like the sea.",
"created_at": "2026-10-17T08:15:00Z"
}