Things URI Scheme

Last Updated: May 18, 2017 05:23PM CEST

This page is for developers who want to send data into Things from their apps.

Available on both macOS and iOS, Things’ URI scheme makes it possible for developers to pass data into Things and create new to-dos.

Schema

Here’s the schema for communicating with Things via URI:

things:command?parameter1=value1&parameter2...

Commands and Parameters

macOS

Display Quick Entry with a new to-do

The add command displays the Quick Entry window pre-filled with the passed parameters. title is a required parameter. Optional parameters include notes and dueDate. Here’s an example:

things:add?title=Buy%20eggs&notes=6&dueDate=2015-12-24
iOS

Open Things and create a new to-do

The open-quick-entry command opens Things and presents a new, empty to-do that’s ready to edit. Here’s what it looks like:

things:open-quick-entry

The `add` command opens Things and presents a new to-do that’s pre-filled with the passed parameters. title is a required parameter. Optional parameters include notes and dueDate. Here’s an example:

things:add?title=Buy%20eggs&notes=6&dueDate=2015-12-24

Open Things and show the Today list

The navigate-today-list command takes you to the Today list in Things. It doesn’t accept any parameters. Here’s what it looks like:

things:navigate-today-list

Questions?

If you’re a developer and have questions about using our URI scheme, please get in touch.



 

Didn’t find what you were looking for?

support@culturedcode.com
https://cdn.desk.com/
culturedcode
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
Invalid characters found
/customer/en/portal/articles/autocomplete