This page contains the setup guide and reference information for the Swoogo integrations.
This integration is part of Free, Starter, Professional, Enterprise subscription. Contact your Account Manager for more information.
Prerequisites
An active Swoogo account with a list of events (ensure you have access, especially if you are not the owner)
Setup guide
Step 1: Set up Swoogo
Log into your Swoogo account.
In the right navigation bar, click My Profile.
On the page, select API Credentials from top navigation bar.
Then copy both the Consumer Key (API Key) and Consumer Secret (API Secret):
Step 2: Set up the Swoogo 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 Swoogo from the list of integrations.
Copy the values displayed in Step 1.4 - Set up Swoogo, using the corresponding Consumer Key (API Key) and Consumer Secret (API Secret) fields.
Click on Submit.
Select your event for integration - The integration displays all events your account has access to, including upcoming and past events.
Your Swoogo 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 Swoogo integration supports the following sync modes :
Feature | Supported? |
Yes | |
Yes |
Supported streams
This integration is supporting the following Swoogo streams
Capturing deleted records
The Swoogo integration does NOT capture deletions for records in the Registrants, Speakers, Sessions streams.
When a record is deleted on Swoogo, it needs to be MANUALY deleted on Swapcard accordingly.
Stream Dependencies
In the context of integration functionalities, records are automatically linked with their corresponding records within Swapcard. For instance, if Speakers are associated with Sessions on Swoogo, the integration will replicate these dependencies within Swapcard.
Speakers → Sessions
The Swoogo integration automatically links the Speakers from Swoogo with their respective Sessions from Swoogo.
The integration utilizes the sessions field from the Speakers stream.
The id of Sessions is employed as the main identifier to uniquely link records and store them within the Client Id field on the Swapcard side.
Streams supporting fields
Registrants
The integration exclusively imports registrants with a registration_status configured as either Confirmed or Attendeed.
Registrant Field | Mapping Label | Type |
| "ID" |
|
| "Reference" |
|
| "Ext Token" |
|
| "Registration Status" |
|
| "Registration Type" |
|
| "Email" |
|
| "Prefix" |
|
| "First Name" |
|
| "Middle Name" |
|
| "Last Name" |
|
| "Suffix" |
|
| "Company" |
|
| "Job Title" |
|
| "Work Phone" |
|
| "Mobile Phone" |
|
| "Gender" |
|
| "Birth Date" |
|
| "Twitter Handle" |
|
| "Profile Picture" |
|
| "Bio" |
|
| "CC Email" |
|
| "Event Id" |
|
| "Contact Id [Webhook Only]" |
|
| "Work Address Name" |
|
| "Work Address Company" |
|
| "Work Address Line 1" |
|
| "Work Address Line 2" |
|
| "Work Address Line 3" |
|
| "Work Address City" |
|
| "Work Address State" |
|
| "Work Address Zip" |
|
| "Work Address Country Code" |
|
| "Work Address Country" |
|
| "Work Address Continent" |
|
| "Work Address Zipcode Required" |
|
| "Work Address Phone" |
|
| "Work Address Website" |
|
| "Work Address Latitude" |
|
| "Work Address Longitude" |
|
| "Home Address Name" |
|
| "Home Address Company" |
|
| "Home Address Line 1" |
|
| "Home Address Line 2" |
|
| "Home Address Line 3" |
|
| "Home Address City" |
|
| "Home Address State" |
|
| "Home Address Zip" |
|
| "Home Address Country Code" |
|
| "Home Address Country" |
|
| "Home Address Continent" |
|
| "Home Address Zipcode Required" |
|
| "Home Address Phone" |
|
| "Home Address Website" |
|
| "Home Address Latitude" |
|
| "Home Address Longitude" |
|
Speakers
Speaker Field | Label | Type |
| "ID" |
|
| "Email" |
|
| "First name" |
|
| "Last name" |
|
| "Company" |
|
| "Job Title" |
|
| "Profile Picture" |
|
| "Bio" |
|
| "Event ID" |
|
| "Created At" |
|
| "Direct Link" |
|
| "Updated At" |
|
Sessions
Session Field | Label | Type |
| "ID" |
|
| "Event ID" |
|
| "Name" |
|
| "Badge Name" |
|
| "Description" |
|
| "Date" |
|
| "Start Time" |
|
| "End Time" |
|
| "Capacity" |
|
| "Notes" |
|
| "Location" |
|
| "Track" |
|
| "Webinar URL" |
|
| "Direct Link" |
|
| "Created At" |
|
| "Updated At" |
|
Limitations & Troubleshooting
Connector limitations
Registrants status
The integration exclusively imports registrants with a registration_status configured as either Confirmed or Attendeed.
Group Registrants
To ensure the proper functioning of the Swapcard product, it is essential that each Registrant contains unique and required information, including:
First name
Last name
Email
Keep in mind that in the case of group registrants, the integration will exclusively consider uniquely mapped email addresses. Please ensure you map distinct email addresses along with their corresponding first and last names to ensure accurate ticket importation.
Rate limiting
The Swoogo integration is designed to operate smoothly within typical usage scenarios and should generally not encounter limitations imposed by the Swoogo API. However, its functionality is dependent on the capabilities of the Swoogo API. For information on rate limits, please consult the Rate limits for the REST API section in the Swoogo documentation. If you encounter rate limits, kindly contact the Swoogo support team for assistance.
Changelog
Version | Date | Subject |
2.7.13 | 2023-09-14 | 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.