x-callback-url Support

About x-callback-url

The x-callback-url specification is a standardized means of specifying inter-app communication on the iOS platform. Third-party apps may implement x-callback-url to provide automated redirection once a specified task is finished.

Launch Center Pro is great for using x-callback-url support in third-party apps, but we also support it for our internal actions. These can be called from thrid-party apps.

Support for Launch Center Pro Actions

In Launch Center Pro, nearly all internal actions support x-callback-url where it would be useful. Here are a few:

launch://brightness

launch://messaging

launch://email

launch://dropbox

launch://clipboard

launch://define (new in 2.2)

launch://speak (new in 2.2)

How to Use

Per the x-callback-url spec, you can make any of these perform a callback by adding two things:

Insert x-callback-url directly after the ://

Add an x-success url parameter to the URL

Examples

Add a photo to dropbox, copy the public link, and launch Tweetbot. Install Action

URL Encode Helper

Notice that the x-success parameter, like all querystring values, must be url-safe or encoded. To make this easier, we offer a special {{}} syntax as you can see in the last example. Text within these brackets will be automatically url encoded at execution time.

Note: For multiple nested x-callback workflows, you may need to manually encode your action as our {{}} helper does not work when nested.