f

X-Callback-Url schemes

nozbe4://x-callback-url schemes

Please bear in mind that this option is for advanced users.

X-Callback-url schemes is a standard for links to open apps in specified view or to trigger performing some action inside an app.

Learn more here:

URL scheme is a special type of link that starts with nozbe4:// and works just like normal https:// links you use every day. Instead of opening a webpage, it opens a specific view in the Nozbe app. Here is an example: nozbe4://goto/teams/TeamID/priority - it opens Nozbe in the Priority view. Below you will find technical documentation.

We implement x-callback-url protocol in our iOS, Android, macOS and Windows apps. It is a useful method for creating workflows and shortcuts from other apps to Nozbe views and actions.

General URL structure

URL Scheme actions look like this:

nozbe4://x-callback-url/ACTION_NAME?secret=YOUR_SECRET&x-success=URL&x-error=URL&param1=VALUE1&param2=VALUE2

GIF

Actions

/goto command

The simplest action that opens specific task list in Nozbe. To get a url to the list you can use copy list link or open Nozbe in a browser and copy url from address bar. Then replace https://nozbe.app part with nozbe4://goto

Examples:

nozbe4://goto/teams/zR17yVDEDrpBbi8x/single_tasks - opens Single Tasks view in a team with ID: zR17yVDEDrpBbi8x

This one action only opens the view so it does not require ?secret=YOUR_SECRET parameter

/add_task command

Required parameters:

Optional:

Returns on success:

Example:

/update_task command

Required:

Optional:

/add_project command

Required:

Optional:

Returns: