Skip to content

URL Schemes

Applies to: iOS, iPadOS, macOSUpdated August 2026

Open App

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 for more information.

timepage://add_event?title=<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 and 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 and index for more information.

timepage://open_weather?day=<day>
timepage://open_weather?week=<"this"|"next"|index>

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.

Was this helpful?

Still stuck?

Contact us and we'll include this article in your message.