&day=<day> ``` "Add Event" also supports x-callback-url in the format: ``` timepage://x-callback-url/add_event?x-success=<success callback url>&x-cancel=<cancel callback url>&<other regular parameters> ``` ## Open Event Open Timepage and show a specified event. ``` timepage://open_event?event=<"next"|event_id> ``` ``` timepage://open_event_map?event=<"next"|event_id> ``` ## Get Directions Open Maps to the location of a specified event. ``` timepage://get_directions?event=<"next"|event_id> ``` ## Message Attendees Open a new SMS message addressed to the attendees of a specified event. ``` timepage://message_attendees?event=<"next"|event_id> ``` ## Countdown Share Open Timepage to the countdown view for a specified event. ``` timepage://countdown_share?event=<"next"|event_id> ``` ## Open Actions Launch the Actions app. ``` timepage://open_actions ``` ## Open Day / Week / Month Open Timepage and show a specified day, week, or month. See [`day`](#day) and [`index`](#index) for more information. ``` timepage://open_day?day=<day> ``` ``` timepage://open_week?week=<"this"|"next"|index> ``` ``` timepage://open_month?month=<"this"|"next"|index> ``` ## Open Weather Open Timepage and show weather for a specified day or week.See [`day`](#day) and [`index`](#index) for more information. ``` timepage://open_weather?day=<day> ``` ``` timepage://open_weather?week=<"this"|"next"|index> ``` ## Search Open Timepage and show search results for the specified search terms. ``` timepage://search?query=<text> ``` ## List Calendars Use x-callback-url to fetch your calendar names. By default it returns your visible calendars; add `writable=1` to return only the calendars you can write to. ``` timepage://x-callback-url/listcalendars?x-success=<success callback url> ``` "List Calendars" calls the success callback url (x-success) with the calendar names as a comma-separated list: ``` calendars=<calendar name,calendar name,...> ``` ## Get Event Use x-callback-url to fetch info about an event. Get a specified event and return its details via a specified callback URL. ``` timepage://x-callback-url/get_event?event=<"next"|event_id>&x-success=<success callback url> ``` "Get Event" calls the success callback url (x-success) with the following parameters: ``` start=<yyyy-mm-dd hh:mm>&end=<yyyy-mm-dd hh:mm>&title=<event title>&location=<event location> ``` --- ## Query parameters ## `day` Can be specified as either: - Date in the format `yyyy-mm-dd` - Special strings "today" or "tomorrow" - Upcoming weekday name (long or short) such as "monday", "tuesday, "wed", etc. Is specific to the language set by the device. Always specifies the next upcoming day with this name. ## `index` Specifies an offset to the current week/month. For example, when opening a specific week, index 0=this week, 1=next week, -1=last week, etc.

# URL Schemes *Applies to: iOS, iPadOS, macOS · Updated 2026-08-13* A reference for Timepage's URL schemes to open the app, add events, get directions, share countdowns, and more. [Original article](https://bonobolabs.com/support/timepage/timepages-url-schemes/) ## Open App ```bash timepage:// ``` ## Add Event Open Timepage to the new event screen. Title and day can be optionally specified. Callback URL can be optionally specified. See [`day`](#day) for more information. ``` timepage://add_event?title=&day=<day> ``` "Add Event" also supports x-callback-url in the format: ``` timepage://x-callback-url/add_event?x-success=<success callback url>&x-cancel=<cancel callback url>&<other regular parameters> ``` ## Open Event Open Timepage and show a specified event. ``` timepage://open_event?event=<"next"|event_id> ``` ``` timepage://open_event_map?event=<"next"|event_id> ``` ## Get Directions Open Maps to the location of a specified event. ``` timepage://get_directions?event=<"next"|event_id> ``` ## Message Attendees Open a new SMS message addressed to the attendees of a specified event. ``` timepage://message_attendees?event=<"next"|event_id> ``` ## Countdown Share Open Timepage to the countdown view for a specified event. ``` timepage://countdown_share?event=<"next"|event_id> ``` ## Open Actions Launch the Actions app. ``` timepage://open_actions ``` ## Open Day / Week / Month Open Timepage and show a specified day, week, or month. See [`day`](#day) and [`index`](#index) for more information. ``` timepage://open_day?day=<day> ``` ``` timepage://open_week?week=<"this"|"next"|index> ``` ``` timepage://open_month?month=<"this"|"next"|index> ``` ## Open Weather Open Timepage and show weather for a specified day or week.See [`day`](#day) and [`index`](#index) for more information. ``` timepage://open_weather?day=<day> ``` ``` timepage://open_weather?week=<"this"|"next"|index> ``` ## Search Open Timepage and show search results for the specified search terms. ``` timepage://search?query=<text> ``` ## List Calendars Use x-callback-url to fetch your calendar names. By default it returns your visible calendars; add `writable=1` to return only the calendars you can write to. ``` timepage://x-callback-url/listcalendars?x-success=<success callback url> ``` "List Calendars" calls the success callback url (x-success) with the calendar names as a comma-separated list: ``` calendars=<calendar name,calendar name,...> ``` ## Get Event Use x-callback-url to fetch info about an event. Get a specified event and return its details via a specified callback URL. ``` timepage://x-callback-url/get_event?event=<"next"|event_id>&x-success=<success callback url> ``` "Get Event" calls the success callback url (x-success) with the following parameters: ``` start=<yyyy-mm-dd hh:mm>&end=<yyyy-mm-dd hh:mm>&title=<event title>&location=<event location> ``` --- ## Query parameters ## `day` Can be specified as either: - Date in the format `yyyy-mm-dd` - Special strings "today" or "tomorrow" - Upcoming weekday name (long or short) such as "monday", "tuesday, "wed", etc. Is specific to the language set by the device. Always specifies the next upcoming day with this name. ## `index` Specifies an offset to the current week/month. For example, when opening a specific week, index 0=this week, 1=next week, -1=last week, etc.