Run a shortcut using a URL scheme
The Shortcuts URL scheme supports running a shortcut that’s saved in the Shortcuts Library. This functionality may be useful in automation systems that extend beyond Shortcuts itself, so that other apps can run a shortcut in your collection. Or you could use the Shortcuts URL scheme in a task manager like OmniFocus or Todoist for running a shortcut as one step in a project.
Run a shortcut from a URL
Open a URL with the following structure:
shortcuts://run-shortcut?name=[name]&input=[input]
Use the following parameters in the URL:
name: The name of the shortcut to run.
input (optional): The initial input into the shortcut. There are two input options: a text string or the word
clipboard
. When theinput
value is a text string, that text is used. When theinput
value isclipboard
, the contents of the clipboard are used.
By using a text string, you can provide your own URL-encoded text as input to the shortcut. For example, a URL that uses the text “
soup
” as input to a shortcut named Make PDF would look like this:shortcuts://run-shortcut?name=Make%20PDF&input=text&text=soup
A URL to transfer the most recently copied text into a shortcut called Add to Bear would look like this:
shortcuts://run-shortcut?name=Add20%to20%Bear&input=clipboard
Tip: If you’d like to run one shortcut from within another shortcut, use the Run Shortcut action instead of a URL scheme. You should only run shortcuts with a URL if you’re integrating from another app outside of Shortcuts.