API: Multiple Events

The AddEvent API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors.
All API access is over HTTPS. All data is sent and received as JSON, including errors.

Data
Please URL encode all parameter values. Your API token is: .

JOB 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

Example with data

https://www.addevent.com/api/v1/me/calendars/list/?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",
		"date_create": 1434422899,
		"date_modified": 1477958407
	}],
	"paging": {
		"previous": "",
		"next": "https:\/\/www.addevent.com\/api\/v1\/calendars\/list\/?token=&page=2"
	}
}

Parameters

Parameter
Description
token
Mandatory   Account token.

JOB 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

Example with data

https://www.addevent.com/api/v1/me/calendars/create/?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
	}
}

Parameters

Parameter
Description
token
Mandatory   Account token.
title
Mandatory   Title of the calendar.

JOB 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

Example with data

https://www.addevent.com/api/v1/me/calendars/save/?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
	}
}

Parameters

Parameter
Description
token
Mandatory   Account token.
title
Mandatory   Title of the calendar.
calendar_id
Mandatory   Id of the calendar to save.

JOB Delete a calendar

Delete a calendar. Returns a deletion status.

$ curl https://www.addevent.com/api/v1/me/calendars/delete/?token=token&calendar_id=calendar_id

Example with data

https://www.addevent.com/api/v1/me/calendars/delete/?token=&calendar_id=14793391331949

Returns

{
	"meta": {
		"code": "200"
	},
	"calendar": {
		"id": "14793391331949",
		"status": "deleted"
	}
}

Parameters

Parameter
Description
token
Mandatory   Account token.
calendar_id
Mandatory   Id of the calendar to delete.

JOB 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

Example with data

https://www.addevent.com/api/v1/me/calendars/events/list/?token=&calendar_id=1473327868906

Returns

{
	"meta": {
		"code": "200"
	},
	"calendar": {
		"id": "1473327868906",
		"events_count": 33
	},
	"events": [{
		"id": "125163",
		"title": "Cookie Fridays",
		"description": "The oven is hot and our cookies are ready to be served :-)\r\n\r\nInclude a link to direct users to: http:\/\/www.example.com\/cookies\r\n\r\nToday's special is Cinnamon Spice stuffed with White Chocolate Chip.\r\n\r\nStop by before 12pm and get yours! Buy one, get one free to all followers.",
		"location": "1416 Valencia St, San Francisco, CA 94110",
		"organizer": "",
		"organizer_email": "",
		"date_start": "04\/21\/2017",
		"date_start_time": "15:00:00",
		"date_start_ampm": "PM",
		"date_start_unix": 1492786800,
		"date_end": "04\/21\/2017",
		"date_end_time": "16:00:00",
		"date_end_ampm": "PM",
		"date_end_unix": 1492790400,
		"all_day_event": "false",
		"date_format": "MM\/DD\/YYYY",
		"timezone": "America\/Los_Angeles",
		"reminder": "15",
		"date_create": 1473984345,
		"date_modified": 1473984345,
		"updated_times": "0"
	}, {
		"id": "125162",
		"title": "Cookie Fridays",
		"description": "The oven is hot and our cookies are ready to be served :-)\r\n\r\nInclude a link to direct users to: http:\/\/www.example.com\/cookies\r\n\r\nToday's special is Cinnamon Spice stuffed with White Chocolate Chip.\r\n\r\nStop by before 12pm and get yours! Buy one, get one free to all followers.",
		"location": "1416 Valencia St, San Francisco, CA 94110",
		"organizer": "",
		"organizer_email": "",
		"date_start": "04\/14\/2017",
		"date_start_time": "15:00:00",
		"date_start_ampm": "PM",
		"date_start_unix": 1492182000,
		"date_end": "04\/14\/2017",
		"date_end_time": "16:00:00",
		"date_end_ampm": "PM",
		"date_end_unix": 1492185600,
		"all_day_event": "false",
		"date_format": "MM\/DD\/YYYY",
		"timezone": "America\/Los_Angeles",
		"reminder": "15",
		"date_create": 1473984345,
		"date_modified": 1473984345,
		"updated_times": "0"
	}],
	"paging": {
		"previous": "",
		"next": "https:\/\/www.addevent.com\/api\/v1\/calendars\/events\/list\/?token=&calendar_id=1473327868906&page=2"
	}
}

Parameters

Parameter
Description
token
Mandatory   Account token.
calendar_id
Mandatory   Id of the calendar.

JOB Create 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

Example with data

https://www.addevent.com/api/v1/me/calendars/events/create/?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=America/Los_Angeles&reminder=60&start_date=08%2F04%2F2017+09%3A00&end_date=08%2F04%2F201711%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": "08\/04\/2017",
		"date_start_time": "09:00:00",
		"date_start_ampm": "AM",
		"date_end": "08\/04\/2017",
		"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",
		"updated_times": "0",
		"date_create": 1479434024,
		"date_modified": 1479434024
	}
}

Parameters

Parameter
Description
token
Mandatory   Account token.
calendar_id
Mandatory   Id of the calendar.
title
Mandatory   Title of the event
description
Description of the event. Use \n for line breaks.
location
Location of the event, e.g. "1600 Amphitheatre Pkwy, Mountain View, CA 94043".
organizer
Organizer of the event, e.g. "Thomas Scott".
organizer_email
Organizer's email, e.g. "thomas@example.com"
timezone
Mandatory   Time zone of the event, e.g. "America/Los_Angeles". View "Timezones" for all time zones available. Uses "America/Los_Angeles" time zone if not defined.
reminder
Set an event reminder. Value is in minutes, e.g. "5" or "10" or "60" or "120" minutes.
start_date
Mandatory   Start date of the event. Accepts numeric dates, e.g. "08/04/2017 09:00" or "08/04/2017 09:00 AM". Accepted format of date: "MM/DD/YYYY HH:MM".
end_date
End date of the event. Accepts numeric dates, e.g. "08/04/2017 11:00" or "08/04/2017 11:00 AM". Accepted format of date: "MM/DD/YYYY HH:MM". If end_date isn't defined, end_date becomes start_date plus 1 hour.
all_day_event
All day event. Defaults to "false". Accepts "true" or "false".

JOB Save 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

Example with data

https://www.addevent.com/api/v1/me/calendars/events/save/?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=America/Los_Angeles&reminder=60&start_date=08%2F04%2F2017+09%3A00&end_date=08%2F04%2F201711%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": "08\/04\/2017",
		"date_start_time": "09:00:00",
		"date_start_ampm": "AM",
		"date_end": "08\/04\/2017",
		"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",
		"updated_times": "1",
		"date_create": 1479434024,
		"date_modified": 1479434024
	}
}

Parameters

Parameter
Description
token
Mandatory   Account token.
event_id
Mandatory   Id of the event.
title
Mandatory   Title of the event
description
Description of the event. Use \n for line breaks.
location
Location of the event, e.g. "1600 Amphitheatre Pkwy, Mountain View, CA 94043".
organizer
Organizer of the event, e.g. "Thomas Scott".
organizer_email
Organizer's email, e.g. "thomas@example.com"
timezone
Mandatory   Time zone of the event, e.g. "America/Los_Angeles". View "Timezones" for all time zones available. Uses "America/Los_Angeles" time zone if not defined.
reminder
Set an event reminder. Value is in minutes, e.g. "5" or "10" or "60" or "120" minutes.
start_date
Mandatory   Start date of the event. Accepts numeric dates, e.g. "08/04/2017 09:00" or "08/04/2017 09:00 AM". Accepted format of date: "MM/DD/YYYY HH:MM".
end_date
End date of the event. Accepts numeric dates, e.g. "08/04/2017 11:00" or "08/04/2017 11:00 AM". Accepted format of date: "MM/DD/YYYY HH:MM". If end_date isn't defined, end_date becomes start_date plus 1 hour.
all_day_event
All day event. Defaults to "false". Accepts "true" or "false".

JOB Delete 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

Example with data

https://www.addevent.com/api/v1/me/calendars/events/delete/?token=&event_id=159051

Returns

{
	"meta": {
		"code": "200"
	},
	"event": {
		"id": "159051",
		"status": "deleted"
	}
}

Parameters

Parameter
Description
token
Mandatory   Account token.
event_id
Mandatory   Id of the event.

JOB List of time zones

Lists 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"
	},
	{
		etc.
	}]
}