The Basics of Working With x-callback URLs

A lot of apps are supported natively in Shortcuts or Workflow, but not all, and Sometimes even if the app is supported not all the features are there. This is no ones fault, they're just a lot of apps. This is where x-callback URLs come in, they give you the ability to write actions in URL form to run in a specific app. I recently talked about how I’m doing this with Things 3. With Shortcuts coming out soon I thought it might be a good idea to share a couple of websites I have been using to help build x-callback URLs that I run in Workflow soon to be Shortcuts.

Resources to build x-callback URLs

  • App Talk is great for a handful of popular apps. They walk you through every URL that is supported for said app. I think this is probably the best place to start if you need to build a x-callback URL.

  • x-callback-url has probably the biggest list of URL supported apps. They link to the apps webpage with the x-callback URL support on there. Unfortunately it looks like they still have some older apps on there and some current apps have broken links. It's great for a majority of apps though.

  • I always like to check out an apps webpage, you may learn a thing or two that you didn't already know. A lot of times developers will have documentation on their URL support right on their site. If they don't have documentation but have some way to reach out for support then send them an email and ask. I try not to do this right away cause I understand how much email developers get.

Building a Workflow/Shortcut with x-callback URL

When I sit down to write out my own URL's for apps I like to use a text editor like Drafts or Pretext. Some of the more complicated x-callback URLs can get pretty long and it's nice to be able to see the whole URL.

Here is an example of how the URL should be formatted: drafts5://x-callback-url/create?text=New%20Video%20Outline

This x-callback URL It will open Drafts 5 and create a new document called “New Video Outline”. Apps have different actions for their URL, not all will use the create feature. This is why I recommend reading up on the app that you wish to work with. This is just what the basic structure of what a x-callback URL will look like.


After you have your URL just paste into a “URL” block in Workflow/Shortcuts and then put the action "Open x-callback URL" under that. When running that Workflow/Shortcut it will push that URL to the app with what you told it to do. In the example case from above, it will create a new task in Things 3 with a lot of checklist items. If you wish you can add more actions in the Workflow/Shortcut to make it even more powerful. This is just the basics of working with plain x-callback URLs, but there is so much more you can do.