Ready to be more productive and integrate with other apps? With iOS Shortcuts & URL Scheme, certain commands can be sent from third-party apps to TickTick and you can build your own workflow through URLs. This guide will explain how it works. 

Shortcuts

We've already prepared some useful commands for you.

If you are using the Shortcuts app, you can open the URLs below and try them out!

• Add tasks to TickTick from clipboard (First row: task title; Other rows: description contents)
• Add tasks to TickTick from clipboard (First row: task title; Other rows: subtasks)
• Add tasks to TickTick from clipboard (Each row: different tasks) 
• Add tasks to TickTick from system input box (First row: task title; Other rows: description contents) 
• Add tasks to TickTick from system input box (First row: task title; Other rows: subtasks) 
• Add tasks to TickTick from system input box (Each row: different tasks) 
• Today's tasks
• Open a specific list
• Open Monthly Calendar view
• Start Pomo

Btw, you can search TickTick in the Shortcuts app to get more commands. We provide 5 commands: add tasks; open the list/smartlist/tag; open calendar view; start pomo; check-in habits.

If you are using the Drafts app, you can open the URLs below and try them out!

• Batch-add tasks to TickTick
• Add tasks with description contents to TickTick
• Add tasks with subtasks to TickTick

URL Scheme 

In addition to the above shortcuts, you can also use the URL Scheme provided by us to build your workflow according to actual needs.

TickTick can execute the following commands:

• Add tasks: create a new task named "Buy some eggs".
• Show smart list: Show the "Today" list.
• Search tasks: Search tasks with the keyword "Meeting". 

All the commands can be sent to TickTick in the following format as a specific URL:

ticktick://v1/command?parameter1=value1&parameter2=value2&…

Open these links will launch TickTick and execute the command. TickTick currently supports three kinds of commands, including "add_task", "show" and "search". In each command, there are one or more parameters, when adding a task, you can input "title", "startDate", "list" and other parameters we provide. Each parameter corresponds to a value, for example when adding a task, the value of "title" can be "Buy some eggs".

If you want to show the smart list "Today" in TickTick, the URL should look like:

ticktick://v1/show?smartlist=today

Descriptions of how to execute each command

1. "add_task" command

This command supports the x-callback-url protocol, in which it allows you to go back to the previous app after successfully adding tasks in TickTick. TickTick currently supports three callback formats: x-success, x-error, and x-cancel callbacks.

"add_task" command will be sent to TickTick in the following format as a specific URL:

ticktick://x-callback-url/v1/add_task?parameter1=value1&parameter2=value2&…&x-success={{next app's scheme}}

The following parameters are included in this command: 

Examples:

Create a task named "Buy some eggs".

ticktick://x-callback-url/v1/add_task?title=buy%20some%20eggs&x-success={{scheme of the next app}}

Create a task named "Buy some eggs" at "6 pm" in "shopping" list.

ticktick://x-callback-url/v1/add_task?title=buy%20some%20eggs&startDate=2018-05-08T18:00:00.000+0000&allDay=false&list=shopping&x-success={{scheme of the next app}}

When using x-success, the following parameters will be returned to the previous app after successfully adding tasks in TickTick: 

2. "show" command

"show" command will be sent to TickTick in the following format as a specific URL:

ticktick:///v1/show?parameter=value

The following parameters are included in this command:

Example:

Show the smart list "Today".

ticktick://v1/show?smartlist=today

3. "search" command

"search" command will be sent to TickTick in the following format as a specific URL:

ticktick:///v1/search?parameter=value

The following parameters are included in this command:

Example:

Search tasks with the keyword "shopping".

ticktick://v1/search?keyword=shopping