Skip to content
bkmark.it
Docs menu

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

  1. Open Settings → Integrations → iPhone and iPad in bkmark.it.
  2. Choose Create a Shortcut key.
  3. 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:

  1. 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.
  2. Get URLs from Shortcut Input.
  3. Get Item from List: First Item of URLs.
  4. 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 variable
      • source (Text): shortcut
  5. 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

StatusMeaning
201Saved. The page's title, saved copy and suggestions arrive within a few seconds.
200 with "duplicate": trueAlready in your library; nothing was duplicated.
400The shared item had no usable web address.
401The key is wrong, expired or revoked.
402A full API key on a library without Pro (a Shortcut key never gets this).
403The 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.