Procraster URL Schemes

Procraster supports integration with other apps via x-callback-url protocol. The x-callback parameters are defined by the x-callback-url protocol and are optional for all actions. If available, these parameters will be called by Procraster. Please note that parameters should be encoded. They are left unencoded for legibility

x-callback parameters

• x-source [your app name]
• x-success [url]
• x-error [url]

Note: Procraster will add the parameters errorCode and errorMessage to the x-error url. If you set the x-error url to “myapp://x-callback-url/OpenTabError” Procraster will call (in case of an unknown tab):

myapp://x-callback-url/OpenTabError?errorCode=908&errorMessage=Unknown tab

Possible error codes:

• 904: Invalid due date
• 905: Invalid start date
• 907: Unknown action
• 908: Unknown tab

/open

Description: Open Procraster and select tab (optional)

procraster://x-callback-url/open?x-source=[your app name]&x-error=[url]&tab=[procraster,timer,stats,tasks]

Parameters:

• tab [procraster,timer,stats,tasks]

Example: Open Procraster

procraster://x-callback-url/open

Example: Open timer tab

procraster://x-callback-url/open?tab=timer

/add-task

Description: Create a new task in a specified list with given name, notes, start and due date

procraster://x-callback-url/add-task?list=[inbox,next,someday]&name=[string]&notes=[string]&start=[unix time stamp]&due=[unix time stamp]

Parameters:

• list [inbox,next,someday] if not set, the task is added to the Inbox
• name [string]
• notes [string]
• start [unix time stamp] in seconds (local time)
• due [unix time stamp] in seconds (local time)

Example: Create new task in the Next list with the name “My New Task” and with the notes “My task notes” that is scheduled for 15 Apr 2014 12:00 GMT and due 20 Apr 2014 12:00 GMT

procraster://x-callback-url/add-task?list=next&name=My New Task&notes=My task notes&start=1397563200&due=1397995200

Example: Create new task named “My New Task” in the default list (Inbox)

procraster://x-callback-url/add-task?name=My New Task

/add-project

Description: Create a new project with given name, notes, start and due date

procraster://x-callback-url/add-project?name=[string]&notes=[string]&start=[unix time stamp]&due=[unix time stamp]

Parameters:

• name [string]
• notes [string]
• start [unix time stamp] in seconds (local time)
• due [unix time stamp] in seconds (local time)

Example: Create new project with the name “My New Project” and with the notes “My project notes” that is scheduled for 15 Apr 2014 12:00 GMT and due 20 Apr 2014 12:00 GMT

procraster://x-callback-url/add-project?name=My New Project&notes=My project notes&start=1397563200&due=1397995200

Example: Create new project named “My New Project”

procraster://x-callback-url/add-project?name=My New Project

/quicktask

Description: Open Procraster QuickTask

procraster://x-callback-url/quicktask

Didn't Help? Contact Support

Ask Other Users

Show All User Guide Articles