Guide

Add “Save to Duet” to your iPhone share sheet

Five minutes, once. After that, any link from Instagram, Facebook, Safari or YouTube is two taps from your dashboard.

1. Get a token

  1. Sign in and open Settings → Access tokens.
  2. Name it iPhone and tap Create token.
  3. Tap Copy for iPhone Shortcut. It copies the full value Bearer duet_…, so there's nothing to type.

2. Create the Shortcut

  1. Open Shortcuts and tap +. Rename it Save to Duet.
  2. Tap ⓘ and turn on Show in Share Sheet.
  3. In the top block, set the input to URLs and Text, and If there's no input to Get Clipboard.

Add each action below by typing its name in the Search bar at the bottom.

3. Ask who sent it (optional)

  1. Add Ask for Input, set the prompt to From? and turn Allow Multiple Lines off.
  2. Add Set Variable right below it: name From, input Provided Input.

4. Send to Duet

  1. Add Get Contents of URL. Tap the URL and enter https://duet-kappa.vercel.app/api/v1/links.
  2. Tap ›. Set Method to POST.
  3. Headers → Add new header: key Authorization, value: paste what you copied in step 1.
  4. Request Body → JSON, then add three Text fields:
    KeyValue
    textthe variable Shortcut Input
    fromthe variable From
    sourceios

5. Show the result

  1. Add Get Dictionary Value: Value for key message in Contents of URL.
  2. Add Show Notification with the variable Dictionary Value. Tap Done.

Using it

In any app, tap Share → More → Save to Duet (add it to Favourites so it's always in the first row). Type who sent it or tap Done. You'll see Saved to Duet: …, and the link appears in your inbox with its summary a few seconds later.

Troubleshooting

Notification saysFix
No Authorization headerAdd the header in step 4.
Authorization header is emptyPaste the copied value into the header's value field.
Token … isn't recognisedPart of the token is missing or extra. Create a new token and use Copy for iPhone Shortcut.
No link found in what was sharedThat share had no link. Copy the link and run the Shortcut again.
Blank notificationCheck the key in step 5 is exactly message.

Still stuck? Contact us with the notification text.