Solutions
- Automated add to calendar button for websites
- Automated add to calendar links for emails
- Calendar & Events API v2
-
Calendar API Deprecated
- List calendars
- Create a calendar
- Save a calendar
- Delete a calendar
- List events in a calendar
- List all events across all calendars
- Create an event in a calendar
- Save an event in a calendar
- Delete an event in a calendar
- List calendar subscribers
- View a subscriber
- Delete a subscriber
- List of time zones
- Events API Deprecated
- Useful Tools
Back to Documentation
Calendar API
We released an updated version of our API in November 2023. While these endpoints are still supported, they will be deprecated over the coming months, and so we reccommend using the new API going forward. Documentation for the updated calendar and event APIs can be found here: API v2 Documentation
warning
The API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors.
All API access is over HTTPS. All data is received as JSON, including errors.
Data
Please URL encode all parameter values.
The API requires an API token to work.
Please sign in or
create an account to receive your
accounts API tokens.
List calendars
Returns a list of calendars. The calendars are sorted by recently saved calendars appearing first.
$ curl https://www.addevent.com/api/v1/me/calendars/list/?token=token
$ curl https://www.addevent.com/api/v1/me/calendars/list/?token=USER-TOKEN-ID Returns
{
"meta": {
"code": "200"
},
"calendars": [{
"id": "145161006114",
"uniquekey": "ic14",
"title": "Add our events to your calendar",
"description": "Select your calendar, and accept the calendar subscription notice. \n\nWhen accepted, all of our events will automatically appear in your calendar application or mobile device.",
"followers_active": "805",
"followers_total": "1427",
"events_total": "100",
"main_calendar": "false",
"template_id": "a20418bkd038dkO",
"link_short": "http:\/\/cal.ae\/eoadiew",
"link_long": "https:\/\/www.addevent.com\/calendar\/pg261852",
"custom_data": "",
"date_create": 1434422899,
"date_modified": 1477958407
}],
"paging": {
"previous": "",
"next": "https:\/\/www.addevent.com\/api\/v1\/me\/calendars\/list\/?token=USER-TOKEN-ID&page=2"
}
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Create a calendar
Creates a calendar. Returns the calendar created.
$ curl https://www.addevent.com/api/v1/me/calendars/create/?token=token&title=title&description=description
$ curl https://www.addevent.com/api/v1/me/calendars/create/?token=USER-TOKEN-ID&title=Add+our+events+to+your+calendar&description=Select+your+calendar%2C+and+accept+the+calendar+subscription+notice.+%0A%0AWhen+accepted%2C+all+of+our+events+will+automatically+appear+in+your+calendar+application+or+mobile+device.
Returns
{
"meta": {
"code": "200"
},
"calendar": {
"id": "14793391331949",
"uniquekey": "XC1949",
"title": "Add our events to your calendar",
"description": "Select your calendar, and accept the calendar subscription notice. \n\nWhen accepted, all of our events will automatically appear in your calendar application or mobile device.",
"timezone": "America/Los_Angeles",
"weekday_begin": "0",
"calendar_color": "2",
"palette_id": "",
"followers_active": "0",
"followers_total": "0",
"events_total": "0",
"template_id": "a20418bkd038dkO",
"template_embed_id": "",
"link_short": "http:\/\/cal.ae\/eoadiew",
"link_long": "https:\/\/www.addevent.com\/calendar\/pg261852",
"custom_data": "",
"date_create": 1479339133,
"date_modified": 1479339133
}
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
title
Required
Title of the event. Single line string.
Title of the event. Single line string.
description
Description of the calendar. Use \n to separate lines. The field accepts plain text.
The description is used on the calendars subscribe page, e.g. https://www.addevent.com/calendar/ic14.
The description is used on the calendars subscribe page, e.g. https://www.addevent.com/calendar/ic14.
timezone
Default time zone for events created in the calendar, e.g. "America/Los_Angeles".
You can find a list of all time zones (Section: List of time zones) at the bottom of this page.
You can find a list of all time zones (Section: List of time zones) at the bottom of this page.
template_id
ID of a "Custom Calendar Page" template, e.g. "a20418bkd038dkO". Uses the "AddEvent default" template if template_id is not defined.
In order to create/access custom templates please go to the Custom Templates for calendars page.
template_embed_id
ID of a "Custom Embeddable Calendar Page" template, e.g. "a20418bkd038dkO". Uses the "AddEvent default" template if template_embed_id is not defined.
In order to create/access custom templates please go to the Custom Templates for embeddable calendars page.
weekday_begin
Weekdays begin on a "Sunday" or "Monday".
Accepts: 0 (for Sunday) or 1 (for Monday)
Example: &weekday_begin=1
Accepts: 0 (for Sunday) or 1 (for Monday)
Example: &weekday_begin=1
calendar_color
Number of the color (dot) to be shown in the calendar in the Dashboard. Typical range to select from 1-20.
The number of color options depends on the number of colors in the palette.
Example: &calendar_color=5
Example: &calendar_color=5
palette_id
ID of the color palette to be used. In order to find the ID of the color palette, go to:
"Edit calendar", scroll down to the color palettes, click the "Change" button, click "Edit" next to the colors options. ID of the color palette appears bottom / left in the "Edit palette" popup
Example: &palette_id=asB7Fg
"Edit calendar", scroll down to the color palettes, click the "Change" button, click "Edit" next to the colors options. ID of the color palette appears bottom / left in the "Edit palette" popup
Example: &palette_id=asB7Fg
custom_data
Allows you to save a JSON string containing keys and values which can be used with a custom calendar templates.
E.g. {"name":"Michael","bannerimage":"https://example.org/.../banner1.jpg"}
The system will collect the keys in the JSON string and make the keys/values available in the template markup.
E.g. use {{name}} or {{bannerimage}} to output the variables in your custom template.
Requires valid JSON. Max length of JSON string is 500 characters.
E.g. {"name":"Michael","bannerimage":"https://example.org/.../banner1.jpg"}
The system will collect the keys in the JSON string and make the keys/values available in the template markup.
E.g. use {{name}} or {{bannerimage}} to output the variables in your custom template.
Requires valid JSON. Max length of JSON string is 500 characters.
Save a calendar
Save a calendar. Returns the calendar saved.
$ curl https://www.addevent.com/api/v1/me/calendars/save/?token=token&title=title&description=description&calendar_id=calendar_id
$ curl https://www.addevent.com/api/v1/me/calendars/save/?token=USER-TOKEN-ID&title=Add+our+events+to+your+calendar&description=Select+your+calendar%2C+and+accept+the+calendar+subscription+notice.+%0A%0AWhen+accepted%2C+all+of+our+events+will+automatically+appear+in+your+calendar+application+or+mobile+device.&calendar_id=14793391331949
Returns
{
"meta": {
"code": "200"
},
"calendar": {
"id": "14793391331949",
"uniquekey": "XC1949",
"title": "Add our events to your calendar",
"description": "Select your calendar, and accept the calendar subscription notice. \n\nWhen accepted, all of our events will automatically appear in your calendar application or mobile device.",
"timezone": "America/Los_Angeles",
"weekday_begin": "0",
"calendar_color": "2",
"palette_id": "",
"followers_active": "0",
"followers_total": "0",
"events_total": "0",
"template_id": "a20418bkd038dkO",
"template_embed_id": "",
"link_short": "http:\/\/cal.ae\/eoadiew",
"link_long": "https:\/\/www.addevent.com\/calendar\/pg261852",
"custom_data": "",
"date_create": 1479339133,
"date_modified": 1479342638
}
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
calendar_id
Required
Id of the calendar to save.
Id of the calendar to save.
title
Required
Title of the event. Single line string.
Title of the event. Single line string.
description
Description of the calendar. Use \n to separate lines. The field accepts plain text.
The description is used on the calendars subscribe page, e.g. https://www.addevent.com/calendar/ic14.
The description is used on the calendars subscribe page, e.g. https://www.addevent.com/calendar/ic14.
timezone
Default time zone for events created in the calendar, e.g. "America/Los_Angeles".
You can find a list of all time zones (Section: List of time zones) at the bottom of this page.
You can find a list of all time zones (Section: List of time zones) at the bottom of this page.
template_id
ID of a "Custom Calendar Page" template, e.g. "a20418bkd038dkO". Uses the "AddEvent default" template if template_id is not defined.
In order to create/access custom templates please go to the Custom Templates for calendars page.
template_embed_id
ID of a "Custom Embeddable Calendar Page" template, e.g. "a20418bkd038dkO". Uses the "AddEvent default" template if template_embed_id is not defined.
In order to create/access custom templates please go to the Custom Templates for embeddable calendars page.
In order to create/access custom templates please go to the Custom Templates for embeddable calendars page.
weekday_begin
Weekdays begin on a "Sunday" or "Monday".
Accepts: 0 (for Sunday) or 1 (for Monday)
Example: &weekday_begin=1
Accepts: 0 (for Sunday) or 1 (for Monday)
Example: &weekday_begin=1
calendar_color
Number of the color (dot) to be shown in the calendar in the Dashboard. Typical range to select from 1-20.
The number of color options depends on the number of colors in the palette.
Example: &calendar_color=5
Example: &calendar_color=5
palette_id
ID of the color palette to be used. In order to find the ID of the color palette, go to:
"Edit calendar", scroll down to the color palettes, click the "Change" button, click "Edit" next to the colors options. ID of the color palette appears bottom / left in the "Edit palette" popup
Example: &palette_id=asB7Fg
"Edit calendar", scroll down to the color palettes, click the "Change" button, click "Edit" next to the colors options. ID of the color palette appears bottom / left in the "Edit palette" popup
Example: &palette_id=asB7Fg
custom_data
Allows you to save a JSON string containing keys and values which can be used with a custom calendar templates.
E.g. {"name":"Michael","bannerimage":"https://example.org/.../banner1.jpg"}
The system will collect the keys in the JSON string and make the keys/values available in the template markup.
E.g. use {{name}} or {{bannerimage}} to output the variables in your custom template.
Requires valid JSON. Max length of JSON string is 500 characters.
E.g. {"name":"Michael","bannerimage":"https://example.org/.../banner1.jpg"}
The system will collect the keys in the JSON string and make the keys/values available in the template markup.
E.g. use {{name}} or {{bannerimage}} to output the variables in your custom template.
Requires valid JSON. Max length of JSON string is 500 characters.
Delete a calendar
Delete a calendar. Returns a deletion status. Please notice. A "main calendar" can't be deleted.
$ curl https://www.addevent.com/api/v1/me/calendars/delete/?token=token&calendar_id=calendar_id
$ curl https://www.addevent.com/api/v1/me/calendars/delete/?token=USER-TOKEN-ID&calendar_id=14793391331949
Returns
{
"meta": {
"code": "200"
},
"calendar": {
"id": "14793391331949",
"status": "deleted"
}
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
calendar_id
Required
Id of the calendar to delete.
Id of the calendar to delete.
List events in a calendar
Returns a list of events in a calendar. The events are sorted by recently created.
$ curl https://www.addevent.com/api/v1/me/calendars/events/list/?token=token&calendar_id=calendar_id
$ curl https://www.addevent.com/api/v1/me/calendars/events/list/?token=USER-TOKEN-ID&calendar_id=1473327868906
Returns
{
"meta": {
"code": "200"
},
"calendar": {
"id": "1473327868906",
"events_count": 33,
"link_short": "http:\/\/cal.ae\/eoadiew",
"link_long": "https:\/\/www.addevent.com\/calendar\/pg261852"
},
"events": [{
"id": "125163",
"unique": "db125163",
"title": "Title of the event",
"eventname": "Title of the event",
"description": "Description of the event",
"location": "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
"organizer": "Thomas Scott",
"organizer_email": "thomas@example.com",
"date_start": "10\/21\/2024",
"date_start_time": "09:00:00",
"date_start_ampm": "AM",
"date_start_unix": 1729501200,
"date_end": "10\/21\/2024",
"date_end_time": "11:00:00",
"date_end_ampm": "AM",
"date_end_unix": 1729508400,
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "America\/Los_Angeles",
"reminder": "60",
"rrule": "",
"template_id": "a20418bkd038dkO",
"color": "2",
"transp": "busy",
"custom_data": "",
"link_short": "",
"link_long": "https:\/\/www.addevent.com\/event\/xh5112744",
"date_create": 1729501200,
"date_modified": 1729501200,
"updated_times": "0"
}, {
"id": "125162",
"unique": "ae125162",
"title": "Title of the event",
"eventname": "Title of the event",
"description": "Description of the event",
"location": "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
"organizer": "Thomas Scott",
"organizer_email": "thomas@example.com",
"date_start": "10\/14\/2024",
"date_start_time": "09:00:00",
"date_start_ampm": "AM",
"date_start_unix": 1728896400,
"date_end": "10\/14\/2024",
"date_end_time": "11:00:00",
"date_end_ampm": "AM",
"date_end_unix": 1728903600,
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "America\/Los_Angeles",
"reminder": "60",
"rrule": "",
"template_id": "a20418bkd038dkO",
"color": "2",
"transp": "busy",
"custom_data": "",
"link_short": "",
"link_long": "https:\/\/www.addevent.com\/event\/xh5112744",
"date_create": 1728896400,
"date_modified": 1728896400,
"updated_times": "0"
}],
"paging": {
"previous": "",
"next": "https:\/\/www.addevent.com\/api\/v1\/me\/calendars\/events\/list\/?token=USER-TOKEN-ID&calendar_id=1473327868906&page=2"
}
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
calendar_id
Required
Id of the calendar.
Id of the calendar.
order_by
List events in the calendar in a specific order.
Accepts: date-asc or date-desc or id-asc or id-desc
Example: &order_by=date-desc
Accepts: date-asc or date-desc or id-asc or id-desc
Example: &order_by=date-desc
month + year
List events in the calendar in a specific month of the year.
Accepts: month combined with year. Month must contain two digits (from 01-12) and year must contain four digits, e.g. "2024".
Example: &month=06&year=2024
Accepts: month combined with year. Month must contain two digits (from 01-12) and year must contain four digits, e.g. "2024".
Example: &month=06&year=2024
upcoming
List upcoming events in the calendar from "now" or from a specific date/time value. Please notice: This parameter set "order_by" to "date-asc" by default.
Accepts: now or a date/time. Date/time can be the following format:
"2024-11-31 17:30:00" or "31-11-2024 11:00:00" or "2024/11/31 09:37am" or "11/31/2024 03:05pm".
Example: &upcoming=now" or "&upcoming=2024/11/31 12:01pm
Example: &upcoming=now" or "&upcoming=2024/11/31 12:01pm
search
Limits the results based on a keyword.
Performs a wildcard search in these event fields: Title of the event, Internal name of the event, Description of the event, Location of the event
Example: &search=Hello+World"
Example: &search=Hello+World"
json_field + json_value
Matches results based on data in the "custom_data" field.
If you have added custom data like e.g. {"tag":"company"} you are able to filter events by setting the parameter "json_field" to "tag" and look for the value "company".
Example: &json_field=tag&json_value=company
If you have added custom data like e.g. {"tag":"company"} you are able to filter events by setting the parameter "json_field" to "tag" and look for the value "company".
Example: &json_field=tag&json_value=company
List all events across all calendars
Returns a list of all events across all calendars. The events are sorted by recently created.
$ curl https://www.addevent.com/api/v1/me/calendars/events/all/?token=token
$ curl https://www.addevent.com/api/v1/me/calendars/events/all/?token=USER-TOKEN-ID Returns
{
"meta": {
"code": "200"
},
"events": [{
"id": "5546043",
"unique": "sm125163",
"title": "Title of the event",
"eventname": "Title of the event",
"description": "Description of the event",
"location": "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
"organizer": "Thomas Scott",
"organizer_email": "thomas@example.com",
"date_start": "10\/21\/2024",
"date_start_time": "09:00:00",
"date_start_ampm": "AM",
"date_start_unix": 1729501200,
"date_end": "10\/21\/2024",
"date_end_time": "11:00:00",
"date_end_ampm": "AM",
"date_end_unix": 1729508400,
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "America\/Los_Angeles",
"reminder": "60",
"rrule": "",
"template_id": "a20418bkd038dkO",
"color": "2",
"transp": "busy",
"custom_data": "",
"link_short": "",
"link_long": "https:\/\/www.addevent.com\/event\/xh5112744",
"date_create": 1729501200,
"date_modified": 1729501200,
"updated_times": "2",
"calendar_id": "145111006114",
"calendar_uniquekey": "ic14",
"calendar_title": "Demo calendar",
"calendar_name": "",
"calendar_followers_active": "3659",
"calendar_followers_total": "7599",
"calendar_events_total": "273",
"calendar_link_short": "http:\/\/cal.ae\/eoadiew",
"calendar_link_long": "https:\/\/www.addevent.com\/calendar\/pg261852",
"calendar_date_create": "2020-06-16 02:48:19",
"calendar_date_modified": "2024-10-09 18:58:19"
}, {
"id": "5546044",
"unique": "tx125164",
"title": "Title of the event",
"eventname": "Title of the event",
"description": "Description of the event",
"location": "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
"organizer": "Thomas Scott",
"organizer_email": "thomas@example.com",
"date_start": "10\/21\/2024",
"date_start_time": "09:00:00",
"date_start_ampm": "AM",
"date_start_unix": 1729501200,
"date_end": "10\/21\/2024",
"date_end_time": "11:00:00",
"date_end_ampm": "AM",
"date_end_unix": 1729508400,
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "America\/Los_Angeles",
"reminder": "60",
"rrule": "",
"template_id": "a20418bkd038dkO",
"color": "2",
"transp": "busy",
"custom_data": "",
"link_short": "",
"link_long": "https:\/\/www.addevent.com\/event\/xh5112744",
"date_create": 1729501200,
"date_modified": 1729501200,
"updated_times": "2",
"calendar_id": "145111006114",
"calendar_uniquekey": "ic14",
"calendar_title": "Demo calendar",
"calendar_name": "",
"calendar_followers_active": "3659",
"calendar_followers_total": "7599",
"calendar_events_total": "273",
"calendar_link_short": "http:\/\/cal.ae\/eoadiew",
"calendar_link_long": "https:\/\/www.addevent.com\/calendar\/pg261852",
"calendar_date_create": "2020-06-16 02:48:19",
"calendar_date_modified": "2024-10-09 18:58:19"
}],
"paging": {
"previous": "",
"next": "https:\/\/www.addevent.com\/api\/v1\/me\/calendars\/events\/all\/?token=USER-TOKEN-ID&page=2"
}
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
order_by
List events in the calendar in a specific order.
Accepts: date-asc or date-desc or id-asc or id-desc or calendar-id-asc or calendar-id-desc
Example: &order_by=date-desc
Accepts: date-asc or date-desc or id-asc or id-desc or calendar-id-asc or calendar-id-desc
Example: &order_by=date-desc
month + year
List events in the calendar in a specific month of the year.
Accepts: month combined with year. Month must contain two digits (from 01-12) and year must contain four digits, e.g. "2024".
Example: &month=06&year=2024
Accepts: month combined with year. Month must contain two digits (from 01-12) and year must contain four digits, e.g. "2024".
Example: &month=06&year=2024
upcoming
List upcoming events in the calendar from "now" or from a specific date/time value. Please notice: This parameter set "order_by" to "date-asc" by default.
Accepts: now or a date/time. Date/time can be the following format:
"2024-11-31 17:30:00" or "31-11-2024 11:00:00" or "2024/11/31 09:37am" or "11/31/2024 03:05pm".
Example: &upcoming=now" or "&upcoming=2024/11/31 12:01pm
Example: &upcoming=now" or "&upcoming=2024/11/31 12:01pm
cals_only
List only events in specified calendars.
Accepts: calendar_id of the calendar. Separate multiple calendars with a comma ",".
Example: &cals_only=145111006114" or "&cals_only=145111006114,145111006115
Example: &cals_only=145111006114" or "&cals_only=145111006114,145111006115
search
Limits the results based on a keyword.
Performs a wildcard search in these event fields: Title of the event, Internal name of the event, Description of the event, Location of the event
Example: &search=Hello+World"
Example: &search=Hello+World"
json_field + json_value
Matches results based on data in the "custom_data" field.
If you have added custom data like e.g. {"tag":"company"} you are able to filter events by setting the parameter "json_field" to "tag" and look for the value "company".
Example: &json_field=tag&json_value=company
If you have added custom data like e.g. {"tag":"company"} you are able to filter events by setting the parameter "json_field" to "tag" and look for the value "company".
Example: &json_field=tag&json_value=company
Create an event in a calendar
Creates an event in a calendar. Returns the event created.
$ curl https://www.addevent.com/api/v1/me/calendars/events/create/?token=token&calendar_id=calendar_id&title=title&description=description&location=location&organizer=organizer&organizer_email=organizer_email&timezone=timezone&reminder=reminder&start_date=start_date&end_date=end_date&all_day_event=all_day_event&custom_data=custom_data
$ curl https://www.addevent.com/api/v1/me/calendars/events/create/?token=USER-TOKEN-ID&calendar_id=1473327868906&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&organizer=Thomas+Scott&organizer_email=thomas%40example.com&timezone=America%2FLos_Angeles&reminder=60&start_date=12%2F05%2F2024+09%3A00&end_date=12%2F05%2F202411%3A00&all_day_event=false&custom_data=null Returns
{
"meta": {
"code": "200"
},
"event": {
"id": 159051,
"calendar": "1473327868906",
"unique": "db125163",
"title": "Title of the event",
"description": "Description of the event",
"location": "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
"organizer": "Thomas Scott",
"organizer_email": "thomas@example.com",
"date_start": null,
"date_start_time": "09:00:00",
"date_start_ampm": "AM",
"date_end": null,
"date_end_time": "11:00:00",
"date_end_ampm": "AM",
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "America\/Los_Angeles",
"reminder": "60",
"rrule": "",
"template_id": "a20418bkd038dkO",
"color": "2",
"transp": "busy",
"custom_data": "null",
"updated_times": "0",
"link_short": "",
"link_long": "https:\/\/www.addevent.com\/event\/xh5112744",
"date_create": 1733389200,
"date_modified": 1733389200 }
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
calendar_id
Required
Id of the calendar to create the event in.
Id of the calendar to create the event in.
title
Required
Title of the event. Single line string.
Title of the event. Single line string.
description
Description of the event. Use \n to separate lines.
The field accepts plain text.
location
Location of the event, e.g. "1600 Amphitheatre Pkwy, Mountain View, CA 94043".
organizer
Event organizer, e.g. "Thomas Scott".
If you fill out organizer you must also include the organizer_email field.
If you include an organizer and an organizer_email, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment".
If you fill out organizer you must also include the organizer_email field.
If you include an organizer and an organizer_email, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment".
organizer_email
Event organizer e-mail, e.g. "thomas@example.com".
If you fill out organizer_email you must also include the organizer field.
If you include an organizer and an organizer_email, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment".
If you fill out organizer_email you must also include the organizer field.
If you include an organizer and an organizer_email, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment".
start_date
Required
Start date of the event. Accepts most date/time formats, e.g. 11/21/2024 03:00 PM (12-hour format) or 21-11-2024 15:00 (24-hour format).
Use numeric values to describe the date, e.g. "12/05/2024" and not textual, e.g. "December 5th, 2024".
Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates
Date examples:
11/21/2024 03:00 PM or 21-11-2024 15:00 or 2024/11/21 03:00 PM or 2024-11-21 15:00
Start date of the event. Accepts most date/time formats, e.g. 11/21/2024 03:00 PM (12-hour format) or 21-11-2024 15:00 (24-hour format).
Use numeric values to describe the date, e.g. "12/05/2024" and not textual, e.g. "December 5th, 2024".
Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates
Date examples:
11/21/2024 03:00 PM or 21-11-2024 15:00 or 2024/11/21 03:00 PM or 2024-11-21 15:00
end_date
End date of the event.
Accepts most date/time formats, e.g. 11/21/2024 05:00 PM (12-hour format) or
21-11-2024 17:00 (24-hour format).
Use numeric values to describe the date, e.g. "12/05/2024" and not textual, e.g. "December 5th, 2024".
Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates
Date examples:
11/21/2024 05:00 PM or 21-11-2024 17:00 or 2024/11/21 05:00 PM or 2024-11-21 17:00
If end is not defined, the end date is automatically set to start date plus one hour.
Use numeric values to describe the date, e.g. "12/05/2024" and not textual, e.g. "December 5th, 2024".
Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates
Date examples:
11/21/2024 05:00 PM or 21-11-2024 17:00 or 2024/11/21 05:00 PM or 2024-11-21 17:00
If end is not defined, the end date is automatically set to start date plus one hour.
timezone
Required
The events time zone, e.g. Europe/Paris or America/Los_Angeles.
The timezone parameter converts the date/time to Zulu time / GMT / UTC. The timezone parameter defaults to "America/Los_Angeles" if a timezone is not defined.
You can find a list of all time zones (Section: List of time zones) at the bottom of this page.
Explanation: The timezone parameter makes sure the date/time is correct no matter if you are in New York or Sydney.
The events time zone, e.g. Europe/Paris or America/Los_Angeles.
The timezone parameter converts the date/time to Zulu time / GMT / UTC. The timezone parameter defaults to "America/Los_Angeles" if a timezone is not defined.
You can find a list of all time zones (Section: List of time zones) at the bottom of this page.
Explanation: The timezone parameter makes sure the date/time is correct no matter if you are in New York or Sydney.
all_day_event
All day event. Accepts true or false.
reminder
Event reminder. Trigger an event reminder e.g. "15" minutes before the event starts.
Accepted input: Number
Example: Reminder "15" minutes before event starts = 15 or
one day before event starts : 60 minutes x 24 hours = 1440.
Event reminders are currently supported by:
- Apple Calendar
- Outlook
Accepted input: Number
Example: Reminder "15" minutes before event starts = 15 or
one day before event starts : 60 minutes x 24 hours = 1440.
Event reminders are currently supported by:
- Apple Calendar
- Outlook
rrule
Recurring rule, e.g. FREQ=WEEKLY;UNTIL=20241110T080000Z;BYDAY=WE,TH,FR
Make the event repeat for a number of times.
Generate Recurring Rule
Recurring rules are advanced and needs to be tested before you publish it. Please notice: The start date/time must match the recurrence rule in order to work in strict calendar systems like Outlook and Apple Calendar.
Recurring rules are currently supported by:
- Apple Calendar
- Google Calendar (using "Direct" and Google Events API)
- Office 365 (using the Microsoft Events API)
- Outlook
- Outlook.com (using Microsoft Events API)
Generate Recurring Rule
Recurring rules are advanced and needs to be tested before you publish it. Please notice: The start date/time must match the recurrence rule in order to work in strict calendar systems like Outlook and Apple Calendar.
Recurring rules are currently supported by:
- Apple Calendar
- Google Calendar (using "Direct" and Google Events API)
- Office 365 (using the Microsoft Events API)
- Outlook
- Outlook.com (using Microsoft Events API)
template_id
ID of a "Custom Event Page" template, e.g. "a20418bkd038dkO". Uses the "AddEvent default" template if template_id is not defined.
In order to create/access custom templates please go to the Custom Templates for events page.
custom_data
Allows you to save a JSON string containing keys and values which can be used with a custom event templates.
E.g. {"name":"Michael","bannerimage":"https://example.org/.../banner1.jpg"}
The system will collect the keys in the JSON string and make the keys/values available in the template markup.
E.g. use {{name}} or {{bannerimage}} to output the variables in your custom template.
Requires valid JSON. Max length of JSON string is 500 characters.
E.g. {"name":"Michael","bannerimage":"https://example.org/.../banner1.jpg"}
The system will collect the keys in the JSON string and make the keys/values available in the template markup.
E.g. use {{name}} or {{bannerimage}} to output the variables in your custom template.
Requires valid JSON. Max length of JSON string is 500 characters.
color
Color of the event as pre-defined in the calendar settings. Accepts 1 to 20.
transp
Determines whether the event appears as "free" or "busy" on the users calendar. Accepts transparent or opaque.
By default, events are set to "free". If the "transp" value doesn't contain any data, the event is "free".
Save an event in a calendar
Save an event in a calendar. Returns the event saved.
$ curl https://www.addevent.com/api/v1/me/calendars/events/save/?token=token&event_id=event_id&title=title&description=description&location=location&organizer=organizer&organizer_email=organizer_email&timezone=timezone&reminder=reminder&start_date=start_date&end_date=end_date&all_day_event=all_day_event&custom_data=custom_data
$ curl https://www.addevent.com/api/v1/me/calendars/events/save/?token=USER-TOKEN-ID&event_id=159051&title=Title+of+the+event&description=Description+of+the+event&location=1600+Amphitheatre+Pkwy%2C+Mountain+View%2C+CA+94043&organizer=Thomas+Scott&organizer_email=thomas%40example.com&timezone=America%2FLos_Angeles&reminder=60&start_date=12%2F05%2F2024+09%3A00&end_date=12%2F05%2F202411%3A00&all_day_event=false&custom_data= Returns
{
"meta": {
"code": "200"
},
"event": {
"id": 159051,
"calendar": "1473327868906",
"unique": "db125163",
"title": "Title of the event",
"description": "Description of the event",
"location": "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
"organizer": "Thomas Scott",
"organizer_email": "thomas@example.com",
"date_start": null,
"date_start_time": "09:00:00",
"date_start_ampm": "AM",
"date_end": "",
"date_end_time": "11:00:00",
"date_end_ampm": "AM",
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "America\/Los_Angeles",
"reminder": "60",
"rrule": "",
"template_id": "a20418bkd038dkO",
"color": "2",
"transp": "busy",
"custom_data": "null",
"updated_times": "1",
"link_short": "",
"link_long": "https:\/\/www.addevent.com\/event\/xh5112744",
"date_create": 1733389200,
"date_modified": 1733389200 }
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
event_id
Required
Id of the event to save.
Id of the event to save.
title
Required
Title of the event. Single line string.
Title of the event. Single line string.
description
Description of the event. Use \n to separate lines.
The field accepts plain text.
location
Location of the event, e.g. "1600 Amphitheatre Pkwy, Mountain View, CA 94043".
organizer
Event organizer, e.g. "Thomas Scott".
If you fill out organizer you must also include the organizer_email field.
If you include an organizer and an organizer_email, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment".
If you fill out organizer you must also include the organizer_email field.
If you include an organizer and an organizer_email, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment".
organizer_email
Event organizer e-mail, e.g. "thomas@example.com".
If you fill out organizer_email you must also include the organizer field.
If you include an organizer and an organizer_email, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment".
If you fill out organizer_email you must also include the organizer field.
If you include an organizer and an organizer_email, the event is considered to be a "meeting" by calendar clients like Outlook. If you don't include the fields, the event is considered to be an "appointment".
start_date
Required
Start date of the event. Accepts most date/time formats, e.g. 11/21/2024 03:00 PM (12-hour format) or 21-11-2024 15:00 (24-hour format).
Use numeric values to describe the date, e.g. "12/05/2024" and not textual, e.g. "December 5th, 2024".
Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates
Date examples:
11/21/2024 03:00 PM or 21-11-2024 15:00 or 2024/11/21 03:00 PM or 2024-11-21 15:00
Start date of the event. Accepts most date/time formats, e.g. 11/21/2024 03:00 PM (12-hour format) or 21-11-2024 15:00 (24-hour format).
Use numeric values to describe the date, e.g. "12/05/2024" and not textual, e.g. "December 5th, 2024".
Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates
Date examples:
11/21/2024 03:00 PM or 21-11-2024 15:00 or 2024/11/21 03:00 PM or 2024-11-21 15:00
end_date
End date of the event.
Accepts most date/time formats, e.g. 11/21/2024 05:00 PM (12-hour format) or
21-11-2024 17:00 (24-hour format).
Use numeric values to describe the date, e.g. "12/05/2024" and not textual, e.g. "December 5th, 2024".
Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates
Date examples:
11/21/2024 05:00 PM or 21-11-2024 17:00 or 2024/11/21 05:00 PM or 2024-11-21 17:00
If end is not defined, the end date is automatically set to start date plus one hour.
Use numeric values to describe the date, e.g. "12/05/2024" and not textual, e.g. "December 5th, 2024".
Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d-m-y format is assumed. If, however, the year is given in a two digit format and the separator is a dash (-, the date string is parsed as y-m-d. To avoid potential ambiguity, it's best to use ISO 8601 (YYYY-MM-DD) dates
Date examples:
11/21/2024 05:00 PM or 21-11-2024 17:00 or 2024/11/21 05:00 PM or 2024-11-21 17:00
If end is not defined, the end date is automatically set to start date plus one hour.
timezone
Required
The events time zone, e.g. Europe/Paris or America/Los_Angeles.
The timezone parameter converts the date/time to Zulu time / GMT / UTC. The timezone parameter defaults to "America/Los_Angeles" if a timezone is not defined.
You can find a list of all time zones (Section: List of time zones) at the bottom of this page.
Explanation: The timezone parameter makes sure the date/time is correct no matter if you are in New York or Sydney.
The events time zone, e.g. Europe/Paris or America/Los_Angeles.
The timezone parameter converts the date/time to Zulu time / GMT / UTC. The timezone parameter defaults to "America/Los_Angeles" if a timezone is not defined.
You can find a list of all time zones (Section: List of time zones) at the bottom of this page.
Explanation: The timezone parameter makes sure the date/time is correct no matter if you are in New York or Sydney.
all_day_event
All day event. Accepts true or false.
reminder
Event reminder. Trigger an event reminder e.g. "15" minutes before the event starts.
Accepted input: Number
Example: Reminder "15" minutes before event starts = 15 or
one day before event starts : 60 minutes x 24 hours = 1440.
Event reminders are currently supported by:
- Apple Calendar
- Outlook
Accepted input: Number
Example: Reminder "15" minutes before event starts = 15 or
one day before event starts : 60 minutes x 24 hours = 1440.
Event reminders are currently supported by:
- Apple Calendar
- Outlook
rrule
Recurring rule, e.g. FREQ=WEEKLY;UNTIL=20241110T080000Z;BYDAY=WE,TH,FR
Make the event repeat for a number of times.
Generate Recurring Rule
Recurring rules are advanced and needs to be tested before you publish it. Please notice: The start date/time must match the recurrence rule in order to work in strict calendar systems like Outlook and Apple Calendar.
Recurring rules are currently supported by:
- Apple Calendar
- Google Calendar (using "Direct" and Google Events API)
- Office 365 (using the Microsoft Events API)
- Outlook
- Outlook.com (using Microsoft Events API)
Generate Recurring Rule
Recurring rules are advanced and needs to be tested before you publish it. Please notice: The start date/time must match the recurrence rule in order to work in strict calendar systems like Outlook and Apple Calendar.
Recurring rules are currently supported by:
- Apple Calendar
- Google Calendar (using "Direct" and Google Events API)
- Office 365 (using the Microsoft Events API)
- Outlook
- Outlook.com (using Microsoft Events API)
template_id
ID of a "Custom Event Page" template, e.g. "a20418bkd038dkO". Uses the "AddEvent default" template if template_id is not defined.
In order to create/access custom templates please go to the Custom Templates for events page.
custom_data
Allows you to save a JSON string containing keys and values which can be used with a custom event templates.
E.g. {"name":"Michael","bannerimage":"https://example.org/.../banner1.jpg"}
The system will collect the keys in the JSON string and make the keys/values available in the template markup.
E.g. use {{name}} or {{bannerimage}} to output the variables in your custom template.
Requires valid JSON. Max length of JSON string is 500 characters.
E.g. {"name":"Michael","bannerimage":"https://example.org/.../banner1.jpg"}
The system will collect the keys in the JSON string and make the keys/values available in the template markup.
E.g. use {{name}} or {{bannerimage}} to output the variables in your custom template.
Requires valid JSON. Max length of JSON string is 500 characters.
color
Color of the event as pre-defined in the calendar settings. Accepts 1 to 20.
transp
Determines whether the event appears as "free" or "busy" on the users calendar. Accepts transparent or opaque.
By default, events are set to "free". If the "transp" value doesn't contain any data, the event is "free".
Delete an event in a calendar
Deletes an event in a calendar. Returns a deletion status.
$ curl https://www.addevent.com/api/v1/me/calendars/events/delete/?token=token&event_id=event_id
$ curl https://www.addevent.com/api/v1/me/calendars/events/delete/?token=USER-TOKEN-ID&event_id=159051
Returns
{
"meta": {
"code": "200"
},
"event": {
"id": "159051",
"status": "deleted"
}
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
event_id
Required
Id of the event to delete.
Id of the event to delete.
List calendar subscribers
Returns a list of calendar subscribers. The subscribers are sorted by recently created.
$ curl https://www.addevent.com/api/v1/me/calendars/subscribers/list/?token=token&calendar_id=calendar_id
$ curl https://www.addevent.com/api/v1/me/calendars/subscribers/list/?token=USER-TOKEN-ID&calendar_id=14793391331949
Returns
{
"meta": {
"code": "200"
},
"summary": {
"subscribers_total": "41",
"subscribers_active": "32"
},
"calendar": {
"header": {
"active": "Active",
"blocked": "Blocked",
"userid": "ID",
"calendar": "Calendar",
"syncs": "Syncs",
"name": "Name",
"email": "Email",
"fld-iocbr": "My secret field",
"ip": "IP",
"city": "City",
"region": "Region",
"country": "Country",
"location": "Location",
"postal": "Postal",
"createdate": "Created",
"lastsyncdate": "Last sync date"
},
"subscribers": [{
"active": "Yes",
"blocked": "False",
"userid": "rt1602020946xb",
"calendar": "Google",
"syncs": "3",
"name": "",
"email": "",
"fld-iocbr": "",
"ip": "11.111.111.11",
"city": "San Francisco",
"region": "California",
"country": "US",
"location": "37.8376,-122.2398",
"postal": "94618",
"createdate": "Oct 6th 21:49pm (UTC)",
"lastsyncdate": "Oct 9th 05:04am (UTC)"
}
]
},
"paging": {
"previous": "",
"next": "https:\/\/www.addevent.com\/api\/me\/calendars\/subscribers\/list\/?token=USER-TOKEN-ID&calendar_id=14793391331949&page=2"
}
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
calendar_id
Required
Id of the calendar.
Id of the calendar.
Sorting
Parameter
Description
page
If the list of subscribers contain more than 20 records the results
are paginated. Use the page parameter to go through the next page of results.
Example:
Example:
$ curl https://www.addevent.com/api/v1/me/calendars/subscribers/list/?token=USER-TOKEN-ID&calendar_id=14793391331949&page=2
status
Use the status parameter to list only subscribers who
are "active", "inactive", "blocked", or "all". If the status parameter isn't
available, "all" is used.
Subscribers are "active" if their calendar vendor/app has made a request to the subscribed calendar feed within the past 30 days.
Example:
Subscribers are "active" if their calendar vendor/app has made a request to the subscribed calendar feed within the past 30 days.
Example:
$ curl https://www.addevent.com/api/v1/me/calendars/subscribers/list/?token=USER-TOKEN-ID&calendar_id=14793391331949&page=2&status=inactive
order
List subscribers in a specific order.
Accepts: "asc" or "desc". Default is "desc".
Example:
Accepts: "asc" or "desc". Default is "desc".
Example:
$ curl https://www.addevent.com/api/v1/me/calendars/subscribers/list/?token=USER-TOKEN-ID&calendar_id=14793391331949&order=desc
View a subscriber
Returns details about a subscriber.
$ curl https://www.addevent.com/api/v1/me/calendars/subscribers/subscriber/?token=token&calendar_id=calendar_id&user_id=user_id
$ curl https://www.addevent.com/api/v1/me/calendars/subscribers/subscriber/?token=USER-TOKEN-ID&calendar_id=14793391331949&user_id=wl150897869af
Returns
{
"meta": {
"code": "200"
},
"calendar": {
"header": {
"active": "Active",
"blocked": "Blocked",
"userid": "ID",
"calendar": "Calendar",
"syncs": "Syncs",
"name": "Name",
"email": "Email",
"fld-iocbr": "My secret field",
"ip": "IP",
"city": "City",
"region": "Region",
"country": "Country",
"location": "Location",
"postal": "Postal",
"createdate": "Created",
"lastsyncdate": "Last sync date"
},
"subscriber": {
"active": "Yes",
"blocked": "False",
"userid": "rm1392020946xb",
"calendar": "Google",
"syncs": "3",
"name": "",
"email": "",
"fld-iocbr": "",
"ip": "11.111.111.11",
"city": "Oakland",
"region": "California",
"country": "US",
"location": "37.8376,-122.2398",
"postal": "94618",
"createdate": "Oct 6th 2024 21:49pm (UTC)",
"lastsyncdate": "Oct 9th 2024 05:04am (UTC)"
}
}
}
Delete a subscriber
Delete a calendar subscriber. Returns a deletion status.
$ curl https://www.addevent.com/api/v1/me/calendars/subscribers/subscriber/delete/?token=token&calendar_id=calendar_id&user_id=user_id
$ curl https://www.addevent.com/api/v1/me/calendars/subscribers/subscriber/delete/?token=USER-TOKEN-ID&calendar_id=14793391331949&user_id=wl150897869af
Returns
{
"meta": {
"code": "200"
},
"calendar": {
"subscriber": {
"userid": "rm1392020946xb",
"status": "deleted"
}
}
}
Parameter
Description
token
Required
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
Account token. The account token is available in the Account section and is incorporated in all code examples on this page.
calendar_id
Required
Id of the calendar.
Id of the calendar.
user_id
Required
Id of the subscriber.
Id of the subscriber.
List of time zones
Lists of all available time zones.
$ curl https://www.addevent.com/api/v1/timezones
Returns
{
"meta": {
"code": 200
},
"data": [{
"label": "Africa/Abidjan",
"offset": "00:00"
}, {
"label": "Africa/Accra",
"offset": "00:00"
}]
}