This page contains the setup guide and reference information for the eventmaker integrations.
Prerequisites
An active eventmaker account with a list of events (ensure you have access, especially if you are not the owner)
Setup guide
Step 1: Set up the eventmaker integration in Swapcard
Sign in to your Swapcard account.
Navigate to your Event page within the Communities section.
In the left navigation bar, go to Event Builder, then select Integrations.
On the integration selection page, choose eventmaker from the list of integrations.
To activate the integration, you will need the next parameters:
Event ID : The Event ID on the eventmaker end.
User Name
Password
Install Name
API key (supplied by eventmaker)
Select your event for integration - The integration displays all events your account has access to, including upcoming and past events.
Your eventmaker event has been successfully linked with your Swapcard event.
You have the flexibility to adjust your integration settings according to the specific data requirements. It's crucial to highlight that the synchronization will only begin when you manually start the integration process and finish the necessary mapping.
Supported sync modes
The eventmaker integration supports the following sync modes :
Feature | Supported? |
Yes |
Supported streams
This integration is supporting the following eventmaker streams
eventmaker documentation is accessible here.
Capturing deleted records
The eventmaker integration does NOT capture deletions for records in the getAllEventGuests or getEventGuest or
getEventGuestFields streams.
When a record is deleted on eventmaker, it needs to be MANUALY deleted on Swapcard accordingly.
Object Mappings(Custom)
The eventmaker integration provides a list of available custom fields for mapping people, which is generated from getPerson, & getEventGuest, also a list of available custom fields for mapping people, which is generated from getEventGuestFields
Stream Dependencies
In the context of integration functionalities, records are automatically linked with their corresponding records within Swapcard. For instance, if Guests are associated with Events on eventmaker, the integration will replicate these dependencies within Swapcard.
Guests → Events
The eventmaker Events integration automatically establishes a connection between Guests from eventmaker and their corresponding Event from eventmaker.
This integration utilizes the guest._id field from the Guest & event._id or guest.event_id field from the Events stream as the primary identifier.
The _id field of People serves as the primary identifier for uniquely linking records. These linked records are stored within the Client Id field on the Event record on the Swapcard side.
Streams supporting fields
Guests as People
People Fields | Label | Type |
FIRST_NAME | First name | string |
LAST_NAME | Last name | string |
string | ||
POSITION | Job title | string |
COMPANY | Company | string |
PHONE_NUMBER | Phone Number | string |
STREET_ADDRESS | Street Address | string |
COUNTRY_NAME | Country Name | string |
Limitations & Troubleshooting
Connector limitations
Maintenance
The eventmaker API is a private source API, which adds complexity to maintenance and may lead to stability issues. Despite these challenges, Swapcard offers a connector to facilitate seamless integration.
Incremental Sync
Integration with Cadium is subject to limitations imposed by the provider's API when it comes to incremental updates. The synchronization frequency is strictly limited to 1 hours
Changelog
Version | Date | Subject |
0.0.9 | 2023-03-28 | Maintenance |
Enhancement
Please be aware that any enhancements to this integration, which encompass any requirements not covered by the existing integration state, will be subject to custom development processes and associated costs.