URL Handler

BusyCal iOS supports URL handlers for creating new events and performing a few other tasks.

Creating Events in BusyCal

You can create a new event in BusyCal using natural language by opening a percent-escaped URL in the following format:

busycal://new/<event description>/<notes>

The URL takes up to 2 parameters. The first is the event description, the second is an optional parameter for notes.

<event description>: The event description must contain an event title, date (today is assumed if no date), and a start time (an all-day event is assumed if no start time). In addition, you can include an optional calendar name preceded by a slash (e.g., /Work), and an optional final parameter containing a URL surrounded by angle brackets (e.g., <www.apple.com>). NOTE: All text must be URL encoded.

<notes>: The text you would like to show in the notes section.

Here are some example natural language phrases for creating events and the corresponding percent escaped URLs:

Baseball game tomorrow

busycal://new/Baseball game tomorrow

Staff meeting Thursday at 10am

busycal://new/Staff meeting Thursday at 10am

Meeting with Joe June 7 at 3pm /Work

busycal://new/Meeting with Joe June 7 at 3pm /Work

Note: /Work must be encoded as %2FWork, preceded by a space %20

Meeting with Joe June 7 at 3pm /Work Some Notes

busycal://new/Meeting with Joe June 7 at 3pm /Work/Some Notes

Note: You must add a space (%20) after the title for the list name to be interpreted /Work (%2FWork)

Apple Earnings Conference Call Tuesday at 2pm <investor.apple.com> Some Notes

busycal://new/Apple Earnings Conference Call Tuesday at 2pm <investor.apple.com> Some Notes

See Quick Entry for more information on the natural language syntax for creating events in BusyCal.

Creating Tasks in BusyCal

You can create a new task in BusyCal using natural language by opening a percent-escaped URL in the following format:

busycal://new/-<task description>/<notes>

The URL takes 2 parameters. The first is the task description, the second is an optional parameter for notes.

-<task description>: To create a task, precede the task description with a hyphen (-). You can provide a due date (an undated task is created if no date is provided), an optional priority via exclamation points (! = low, !! = medium, !!! = high), an optional calendar name preceded by a slash (e.g., /Work), and an optional final parameter containing a URL surrounded by angle brackets (e.g., <www.apple.com>).

<notes>: New in v3.5.8+. The text you would like to show in the notes section.

Here are some example natural language phrases for creating tasks and the corresponding percent-escaped URLs: