Dateful Eventlink API

Use URL parameters to link to Dateful Eventlink

The Basics

You can link to Dateful Eventlink without using our form and instead using parameters in the URL. This is handy if you want to programatically include links many times throughout a website. The following features, however, are not available using this method: event description, event URL, add to calendar, recurring dates, and custom image.

Parameter values must be URL encoded. In our documentation, however, we show both unencoded and encoded values for clarity.

These examples show the many ways you can link to Dateful Eventlink.

Parameter iso for ISO 8601

https://dateful.com/eventlink/e/?iso=2021-04-05T12:30-02:00
https://dateful.com/eventlink/e/?iso=2021-04-05T12%3A30-02%3A00

https://dateful.com/eventlink/e/?iso=2009-01-01T12:00+01:00
https://dateful.com/eventlink/e/?iso=2009-01-01T12%3A00%2B01%3A00

Your development tools probably support this format. XKCD said it best.

Parameter title

https://dateful.com/eventlink/e/?iso=20210305T0130&title=My Great Event
https://dateful.com/eventlink/e/?iso=20210305T0130&title=My%20Great%20Event

This sets the name of the event at the top of the page. You can also set this using msg instead of title.

Parameter t only

https://dateful.com/eventlink/e/?t=August 13 2020 at 11am PDT
https://dateful.com/eventlink/e/?t=August%2013%202020%20at%2011am%20PDT

https://dateful.com/eventlink/e/?t=Today at 9pm EST
https://dateful.com/eventlink/e/?t=Today%20at%209pm%20EST

Dateful Eventlink will take its best guess handling a range of time formats. Note: this method will always display the event's local time in UTC.

Parameters t, d, and tz

https://dateful.com/eventlink/e/?t=15:00&tz=Honolulu-Hawaii&d=2022-05-01
https://dateful.com/eventlink/e/?t=15%3A00&tz=Honolulu-Hawaii&d=2022-05-01

The tz parameter can be the long name of any timezone from the dropdown menu on Dateful.

Feedback

This site was created by Jonathan Berger. Get in touch at jonathan@dateful.com