In the dynamic realm of event management, flexibility and adaptability are paramount. Event Cadence recognizes that every event organizer has unique needs and platform preferences, whether stemming from primary data repositories, specialized ticket sales, or established partnerships. That's why, alongside our own robust registration capabilities, we've forged integrations with industry leaders like Cvent and Eventbrite . For those seeking even more customization, our Attendees Data Feed API awaits.
- Always have up-to-date attendee details.
- Tailor experiences with granular attendee data.
- Minimize manual errors with automated data processes.
- Rely on stringent authentication and authorization measures to keep attendee data safe
Dive into this documentation to understand how our API, specifically designed for Event Cadence, allows seamless acceptance of attendee data via HTTP push. From its support for JSON objects and plain key-value collection payload formats to authorization through the payload body or by using the Api-Key HTTP header, enhance your event management capabilities with us. We're here to collaborate, broadening your integration horizons for unmatched event success.
To use this API, you will need the API Gateway address specific to your event. Please contact the Customer Success team to obtain this address.
Authorization for accessing the API can be done using a pre-generated API key, which will be provided to you by our customer success team for your event. There are two ways to pass the API key:
.1: Include the API key in the payload body under the key field.
.2: Add an Api-Key header with your API key.
JSON Object Structure
The API accepts JSON objects with the following structure:
{
"profile": {
"thirdPartyId": null,
"prefix": null,
"firstName": null,
"lastName": null,
"email": null,
"phone": null,
"website": null,
"facebook": null,
"twitter": null,
"linkedin": null,
"instagram": null,
"title": null,
"department": null,
"company": null,
"city": null,
"state": null,
"country": null,
"assistantName": null,
"assistantPhone": null,
"assistantEmail": null,
"motto": null,
"biography": null,
"customFields": [
{
"fieldName": "cf name",
"fieldValue": "value"
}
]
},
"eventInfo": {
"groups": {
"groupNames": [
"name1"
]
}
},
"key": null }
Plain Key-Value Collection
Alternatively, you can use a plain key-value collection in your JSON payload:
{
"profile.thirdPartyId": null,
"profile.prefix": null,
"profile.firstName": null,
"profile.lastName": null,
"profile.email": null,
"profile.phone": null,
"profile.website": null,
"profile.facebook": null,
"profile.twitter": null,
"profile.linkedin": null,
"profile.instagram": null,
"profile.title": null,
"profile.department": null,
"profile.company": null,
"profile.city": null,
"profile.state": null,
"profile.country": null,
"profile.assistantName": null,
"profile.assistantPhone": null,
"profile.assistantEmail": null,
"profile.motto": null,
"profile.biography": null,
"profile.customFields[0].fieldName": "field1",
"profile.customFields[0].fieldValue": "value1",
"profile.customFields[1].fieldName": "field2",
"profile.customFields[1].fieldValue": "value2",
"eventInfo.groups.groupNames.0": "Group1",
"eventInfo.groups.groupNames.1": "Group2",
"key": null }
Please note that the email field is necessary, while all other fields are optional. If any field is not provided, it will not be cleared in Event Cadence, and its value will remain as it was.
- : If the request is well-formatted and accepted, Event Cadence will respond with a 200 status code.
- : If the authorization key is invalid, Event Cadence will respond with a 401 status code.
- : For any other errors, Event Cadence will respond with a 500 status code, and error details will be included in the response body.
Here's an example of how to use this API to send attendee data to Event Cadence:
Request
POST https://your-event-api-gateway.com/attendees
Api-Key: your-api-key
Content-Type: application/json
{
"profile": {
"email": "john.doe@example.com",
"firstName": "John",
"lastName": "Doe"
},
"eventInfo": {
"groups": {
"groupNames": ["Group1"]
}
}
Response