Save to bkmark.it from the iOS share sheet
iOS can't send shares to an installed web app, so on iPhone and iPad you save with a Shortcut that calls the API with a Shortcut key. It works on every plan, Free included, and takes about two minutes to set up.
1. Create a Shortcut key
- Open Settings → Integrations → iPhone and iPad in bkmark.it.
- Choose Create a Shortcut key.
- Copy the key (
bk_live_…). It is shown once. If you lose it, revoke it under Settings → API and webhooks and make a new one.
A Shortcut key can do one thing: save a bookmark (POST /v1/bookmarks) to your personal library.
Everything else, reads included, answers 403. You get one per library; Free allows no other keys.
On Pro you can also make a full API key with New key under Settings → API and webhooks
(give it only bookmarks:write); it works the same way in the Shortcut.
The API call behind the button is POST /v1/api-keys with
{"name": "iOS Shortcut", "scopes": ["bookmarks:write"], "captureOnly": true} (optionally
libraryId for a team library you belong to).
2. Build the Shortcut
In the Shortcuts app, tap + and add these actions in order:
- Receive URLs and Text from Share Sheet. (Tap the shortcut's info button and turn on Show in Share Sheet if it isn't on.) If there's no input: Stop and respond.
- Get URLs from Shortcut Input.
- Get Item from List: First Item of URLs.
- Get Contents of URL:
- URL:
https://api.bkmark.it/v1/bookmarks - Method: POST
- Headers:
Authorization:Bearer bk_live_…(your key)Content-Type:application/json
- Request Body: JSON
url(Text): the Item from List variablesource(Text):shortcut
- URL:
- Optional: Show Notification "Saved to bkmark.it".
Name it "Save to bkmark.it". It now appears in the share sheet of Safari and most apps.
What the API answers
| Status | Meaning |
|---|---|
201 | Saved. The page's title, saved copy and suggestions arrive within a few seconds. |
200 with "duplicate": true | Already in your library; nothing was duplicated. |
400 | The shared item had no usable web address. |
401 | The key is wrong, expired or revoked. |
402 | A full API key on a library without Pro (a Shortcut key never gets this). |
403 | The key lacks the bookmarks:write scope, or a Shortcut key was used for anything but saving. |
A Shortcut key is locked to the library it was made for. To save into a team library, make the key
for that library (libraryId), or on Pro use a full key with an X-Library-Id header.
Keeping the key safe
A Shortcut key can save to your library and nothing more: it can't read, change or delete anything. Anyone with the Shortcut file can still save into your library with it, so don't share the Shortcut. Revoke a lost key from Settings → API and webhooks; it stops working on the next request.
Prefer not to use a key? Forward or send links to your private save address (Settings → Integrations → Email to save) instead.