Menu
more_horiz
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.
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=API-TOKEN 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",
"date_create": 1434422899,
"date_modified": 1477958407
}],
"paging": {
"previous": "",
"next": "https:\/\/www.addevent.com\/api\/v1\/me\/calendars\/list\/?token=API-TOKEN&page=2"
}
}
$ 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=API-TOKEN&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.",
"followers_active": "0",
"followers_total": "0",
"events_total": "0",
"date_create": 1479339133,
"date_modified": 1479339133
}
}
$ 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=API-TOKEN&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.",
"followers_active": "0",
"followers_total": "0",
"events_total": "0",
"date_create": 1479339133,
"date_modified": 1479342638
}
}
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=API-TOKEN&calendar_id=14793391331949
Returns
{
"meta": {
"code": "200"
},
"calendar": {
"id": "14793391331949",
"status": "deleted"
}
}
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=API-TOKEN&calendar_id=1473327868906
Returns
{
"meta": {
"code": "200"
},
"calendar": {
"id": "1473327868906",
"events_count": 33
},
"events": [{
"id": "125163",
"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": "11\/21\/2019",
"date_start_time": "09:00:00",
"date_start_ampm": "AM",
"date_start_unix": 1574326800,
"date_end": "11\/21\/2019",
"date_end_time": "11:00:00",
"date_end_ampm": "AM",
"date_end_unix": 1574334000,
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "",
"reminder": "60",
"date_create": 1574326800,
"date_modified": 1574326800,
"updated_times": "0"
}, {
"id": "125162",
"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": "11\/14\/2019",
"date_start_time": "09:00:00",
"date_start_ampm": "AM",
"date_start_unix": 1573722000,
"date_end": "11\/14\/2019",
"date_end_time": "11:00:00",
"date_end_ampm": "AM",
"date_end_unix": 1573729200,
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "",
"reminder": "60",
"date_create": 1573722000,
"date_modified": 1573722000,
"updated_times": "0"
}],
"paging": {
"previous": "",
"next": "https:\/\/www.addevent.com\/api\/v1\/me\/calendars\/events\/list\/?token=API-TOKEN&calendar_id=1473327868906&page=2"
}
}
$ 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
$ curl https://www.addevent.com/api/v1/me/calendars/events/create/?token=API-TOKEN&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=%3C%3Fphp+echo+%3B+%3F%3E&reminder=60&start_date=12%2F20%2F2019+09%3A00&end_date=12%2F20%2F201911%3A00&all_day_event=false
Returns
{
"meta": {
"code": "200"
},
"event": {
"id": 159051,
"calendar": "1473327868906",
"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": "12\/20\/2019",
"date_start_time": "09:00:00",
"date_start_ampm": ""AM"",
"date_end": "12\/20\/2019",
"date_end_time": "11:00:00",
"date_end_ampm": ""AM"",
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "",
"reminder": "60",
"updated_times": "0",
"date_create": 1576832400,
"date_modified": 1576832400
}
}
$ 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
$ curl https://www.addevent.com/api/v1/me/calendars/events/save/?token=API-TOKEN&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=%3C%3Fphp+echo+%3B+%3F%3E&reminder=60&start_date=12%2F20%2F2019+09%3A00&end_date=12%2F20%2F201911%3A00&all_day_event=false
Returns
{
"meta": {
"code": "200"
},
"event": {
"id": 159051,
"calendar": "1473327868906",
"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": "12\/20\/2019",
"date_start_time": "09:00:00",
"date_start_ampm": "AM",
"date_end": "12\/20\/2019",
"date_end_time": "11:00:00",
"date_end_ampm": "AM",
"all_day_event": "false",
"date_format": "MM\/DD\/YYYY",
"timezone": "",
"reminder": "60",
"updated_times": "1",
"date_create": 1576832400,
"date_modified": 1576832400
}
}
$ 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=API-TOKEN&event_id=159051
Returns
{
"meta": {
"code": "200"
},
"event": {
"id": "159051",
"status": "deleted"
}
}
$ 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"
},
{
etc.
}]
}