What is an Event?
An event is a gathering of people (contacts), for a common purpose, at a specified time and a place. The event could be a scheduled concert, sale, fundraiser, conference, training, etc., and takes place either physically or virtually.
Events help your business prosper in a number of ways, such as building brand recognition and loyalty, increasing revenue, and improving contact engagement and relationships. For example, you might consider hosting a free training event to showcase features that are only available in the latest version of your software. Attendees that complete the training will receive a certification and a discount promotion code to upgrade to the latest version.
The V3 API currently supports event endpoints that allow you to get details about one or more events or event registrations.
Event Endpoints
Use the following event endpoints to get details about events:
GET All Events
GET https://api.cc.email/v3/events/
Use this endpoint to get details for a collection of events under this account. It is useful for gaining a broad perspective on all events associated with an account and you can use the results to create dashboards, calendars, or other applications that display all upcoming or past events.
Use the limit query parameter to control the number of events returned per page, making it efficient for handling large datasets. This is crucial for performance and not overwhelming your application or the user with too much data at once.
GET Details for a One Event
GET https://api.cc.email/v3/events/{event_id}
Use this endpoint to get a deeper, more granular view of a specific event (by event_id). It returns event details such as the event’s title, dates, location, fees, and promotional codes.
Event Registration Endpoints
Get All Registrations for an Event
GET https://api.cc.email/v3/events/{event_id}/tracks/{tracks_id}/registrations
Use this endpoint to return all registrations for an event
Get Details for an Registration
GET https://api.cc.email/v3/events/{event_id}/tracks/{track_key}/registrations/{registration_id}
Use this endpoint to get details for a specific registration (registration_id) and for a specific event (event_id).
Event Schema
Learn about Event Schema
Note: You can create and manage events using the Constant Contact UI.