Run a shortcut using an URL scheme

The Shortcuts URL scheme supports running a shortcut that’s saved in My Shortcuts. 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 the input value is a text string, that text is used. When the input value is clipboard, 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 another shortcut, use the Run Shortcut action instead of a URL scheme. You should only run shortcuts with an URL if you’re integrating from another app outside of Shortcuts.

Not all apps, services and content are available in all countries or regions.
Morty Proxy This is a proxified and sanitized view of the page, visit original site.
Helpful?
Character limit: 250
Maximum character limit is 250.
Thanks for your feedback.
Morty Proxy This is a proxified and sanitized view of the page, visit original site.