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.
URL Scheme actions look like this:
?x-success=URL- (optional) this URL will be opened if action is performed successfully, with
?x-source=Nozbeappended (and optionally other parameters)
?x-error=URL- (optional) this URL will be opened on error, with
?errorCode=1&errorMessage=Some+Error+Messageappended. If not provided, error will be displayed to the user instead
?secret=YOUR_SECRET- (required!) - authentication code, generated in app menu -> settings -> advanced -> x-callback-url. DO NOT SHARE THIS CODE WITH ANYONE
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/teams/zR17yVDEDrpBbi8x/single_tasks - opens Single Tasks view in a team with ID:
This one action only opens the view so it does not require
?responsible_id=ID- ID of member responsible for task. If blank (
?responsible_id=), task won’t be assigned. If not provided at all, it will default to YOU
?due_at=TIMESTAMP- Due date for task, expressed as millisecond (!) epoch time
?is_all_day=true- pass if due date is a full day, without time specified
?comment=TEXT- optional comment to append to task
Returns on success:
?is_priority=(true|false)- marks task as priority/not priority
?is_completed=(true|false)- marks task as completed/not completed
?is_open=true(true - project has open access, false - project is private to you)
?color=COLOR_NAME, one of:
red, yellow, sand, darkgreen, stone, pink, orange, dustpink, olive, lightblue, lightpink, ocher, taupe, green, blue, heather, brown, burntsienna, aquamarine, ultramarine, purple, karmin, mauve, teal, indigo, deeppurple, aubergine, midnight, ocean, navy, pedro, toto, fluffy, felus, luna, rufus, maja, elwi