What is the format of Todo's Import URLs?

We encourage you to take advantage of Todo's task import features by utilizing Todo's special URL scheme. When users click on a Todo Import URL on their iPhone/iPod touch, Todo will be launched and the user will be prompted to import the specified task directly into their task list.

  • Basic Format:
    • appigotodo://<Sending App ID>/import?<Import Parameters>
      • Sending App ID: Reverse DNS Format, eg. "com.example.xyzapp"
  • Required Parameters:
    • name=<URL-Escaped Task Name>
      • Example: "name=Buy%20some%20milk"
  • Optional Parameters:
    • note=<URL-Escaped Note>
      • Example: "note=Stop%20on%20the%20way%20home%20from%20work."
    • due-date=<ISO 8601 Date (no time)>
      • Example: "due-date=2009-07-16"
    • priority=<Integer Value>
      • 1 = High Priority
      • 2 = Medium Priority
      • 3 = Low Priority
      • 4 = No Priority
      • Example: "priority=1"
    • repeat=<Integer Value>
      • 0 = No Repeat
      • Repeat from Due Date
        • 1 = Weekly
        • 2 = Monthly
        • 3 = Yearly
        • 4 = Daily
        • 5 = Bi-weekly
        • 6 = Bi-monthly
        • 7 = Semi-annually
        • 8 = Quarterly
        • 9 = With parent
        • 50 = Advanced (Use data from "advanced-repeat")
      • Repeat from Completion Date>
        • 101 = Weekly
        • 102 = Monthly
        • 103 = Yearly
        • 104 = Daily
        • 105 = Bi-weekly
        • 106 = Bi-monthly
        • 107 = Semi-annually
        • 108 = Quarterly
        • 109 = With parent
        • 150 = Advanced (Use data from "advanced-repeat")
    • advanced-repeat=<Advanced Repeat String>
      • Todo will honor the following three formats for advanced repeating
        • Format 1: Every <X> <T>
          • <X> is a number
          • <T> is a unit of time
            • day, week, month, year
          • Examples:
            • Every 3 days
            • Every 1 month
            • Every 2 years
            • Every 16 weeks
        • Format 2: The <X> <D> of each month
          • <X> is a number or numerical word
            • first, second, last, etc.
          • <D> is a day of the week
            • Mon, Tue, Wed, etc.
          • Examples:
            • The second Monday of each month
            • The last Fri of each month
            • The 3 Sat of each month
        • Format 3: Every <W>
          • <W> is a day of the week or a special word
            • Mon, Tue, Wed, etc.
            • weekend, weekday
          • Examples:
            • Every Mon
            • Every Tuesday and Thursday
            • Every Weekend
            • Every Weekday
            • Every Mon, Wed and Fri
  • Example (must be all one-line):