IMPORTANT: The information on this page is obsolete. Please refer to the new task importing mechanism provided through the x-callback-url methods: http://support.appigo.com/solution/categories/142581/folders/239499/articles/179661-third-party-integration-with-todo-ios-apps


Do you have an app or website that you'd like to send a task to Todo on and iPhone or iPad? Use Todo's URL handler. The length of URLs is controlled by iOS, so while you can import a fair amount of data, don't plan on importing a novel.

Keep in mind as well that all Todo apps from Appigo register to handle the "appigotodo://" scheme. With multiple versions of Todo installed, the OS is free to choose whichever one it will (it's undefined and uncontrollable).

Here are some of the URL options you may want to try from your app/website:

Launch Todo:
  Option 1: appigotodo://
  Option 2: appigotodo://{your app id/website DNS name} (e.g., appigotodo://www.example.com/)

Create a simple task:
  appigotodo://example.com/import?name={URL-escaped-task-name}

  Examples:
  appigotodo://example.com/import?name=Buy%20milk
  appigotodo://example.com/import?name=Pick%20up%20dry%20cleaning

Additional Parameters (values must be URL-escaped)

  name - The name of the task to create (REQUIRED)
  Format: URL-escaped

  note - A note to attach to the task (OPTIONAL)
  Format: URL-escaped

  due-date - The task's due date (OPTIONAL)
  Format: YYYY-MM-DD
  Example: 2013-09-30

  priority - The task's priority (OPTIONAL)
  Values
  0 - no priority
  1 - high priority
  2 - medium priority
  3 - low priority

  repeat - The task's recurrence rule (OPTIONAL)
  Values
  0 - None

  Repeat from Due Date when completed
  1 - Weekly
  2 - Monthly
  3 - Yearly
  4 - Daily
  5 - Biweekly
  6 - Bimonthly
  7 - Semiannually
  8 - Quarterly
  50 - Advanced repeat (see options below)

  Repeat from Completion Date
  101 - Weekly
  102 - Monthly
  103 - Yearly
  104 - Daily
  105 - Biweekly
  106 - Bimonthly
  107 - Semiannually
  108 - Quarterly
  150 - Advanced repeat (see options below)

  advanced-repeat - Specify advanced recurrence rules (OPTIONAL)
  Requires "repeat" value to be specified as "50" or "150"
  Sample Values
  Every%20tue%20and%20thu  (repeat every tuesday and thursday)

Importing Multiple Tasks at once
To append multiple tasks in the same URL call (keep in mind URL length limits), append a 1-based task number to each additional task's parameter name. For example, this would import two tasks:

  appigotodo://example.com/import?name=Buy%20millk&name1=Buy%20oranges