This page contains the setup guide and reference information for the Map Your Show integration.
Prerequisites
An active Map Your Show account with a list of events (ensure you have access, especially if you are not the owner)
Setup guide
Step 1: Set up the Map Your Show 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 Map Your Show from the list of integrations.
To activate the integration, you will need three parameters, all supplied by Map Your Show:
Username
Password
Client ID
Click on Submit.
Select your event for integration — the integration displays all events your account has access to, including upcoming and past events.
Your Map Your Show 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 is important to note that synchronization will only begin once you manually start the integration and complete the necessary mapping.
Supported sync modes
The Map Your Show integration supports the following sync modes:
Feature | Supported? |
Yes | |
Yes |
Supported streams
This integration supports the following Map Your Show streams:
Exhibitors — retrieved through the
/Exhibitors/Modifiedendpoint withfromDateandtoDatefiltering. On the first sync, the range starts from the show's earliest exhibitor record (returned by/Exhibitors/FirstDate) so no historical exhibitor is missed.Exhibitor Members — imported from the
contactsfield that is embedded in each exhibitor returned by the Exhibitors stream. There is no separate API call for exhibitor members.
Capturing deleted records
The Map Your Show integration does NOT capture deletions for Exhibitors or Exhibitor Members.
When a record is deleted on Map Your Show, it needs to be MANUALLY 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 exhibitors are associated with contacts on Map Your Show, the integration will replicate these dependencies within Swapcard.
Exhibitors → Exhibitor Members
⚠️ Exhibitor Members are only synced if the Exhibitors stream is enabled.
Because exhibitor members come from the contacts array nested inside each exhibitor record, disabling the Exhibitors stream prevents any exhibitor members from being imported, even when the Exhibitor Members stream is enabled on its own.
The Map Your Show integration automatically links contacts from Map Your Show with their respective exhibitors and creates the corresponding Exhibitor Member on Swapcard.
The exhid field from the Exhibitors stream is used as the unique identifier and is stored in the Client Id field on the Swapcard side.
For Exhibitor Members, the integration uses a combination of the exhibitor's exhid and the contact's email as the unique identifier, also stored in the Client Id field on Swapcard.
Streams supporting fields
Exhibitors
Exhibitors Field | Mapping Label | Type |
| "Exhibitor ID" |
|
| "Package" |
|
| "Company Name" |
|
| "Alpha" |
|
| "Address 1" |
|
| "City" |
|
| "State" |
|
| "ZIP Code" |
|
| "Country" |
|
| "Email" |
|
| "Phone" |
|
| "Fax" |
|
| "Website" |
|
| "Company Presentation" |
|
| "Is Active" |
|
| "Twitter" |
|
| "LinkedIn" |
|
| "Facebook" |
|
| "Instagram" |
|
| "Company logo URI" |
|
| "Booth Code" |
|
| "Pavilion" |
|
| "Hall ID" |
|
| "Dimension" |
|
| "Booth Type" |
|
| "Hall" |
|
| "Square Feet" |
|
| "Booth Type Display" |
|
| "Booth Tags" |
|
| "Product Category ID" |
|
| "Product Category Name" |
|
| "Product Category Display" |
|
| "Swapcard Listing" |
|
| "New Exhibitor" |
|
Exhibitor Members (from the contacts array on each Exhibitor)
Contacts Field | Mapping Label | Type |
| "First Name" |
|
| "Last Name" |
|
| "Full Name" |
|
| "Email" |
|
| "Phone Number" |
|
| "Title" |
|
| "Address Line 1" |
|
| "Address Line 2" |
|
| "City" |
|
| "State" |
|
| "Zip Code" |
|
| "Country" |
|
| "Fax" |
|
Limitations & Troubleshooting
Inactive Exhibitors
When the Map Your Show integration is first added to a Swapcard event, a default Import Filter is configured automatically on the Exhibitors row:
Field | Operator | Value |
| Is |
|
This filter keeps exhibitors marked as inactive on Map Your Show (isactive: 0) out of Swapcard. Only exhibitors with isactive: 1 are imported.
The filter is visible and editable in Studio, like any other Import Filter — see the Import Filters article for the full reference.
Exhibitor Members require Exhibitors
As described in Stream Dependencies, exhibitor members are pulled from each exhibitor's contacts array. If the Exhibitors stream is disabled, no exhibitor members will be imported.
Issue Connecting to My MYS Account
If you encounter the error [MYS] Status 401. User not logged in or invalid authorization during Step 1: Set up the Map Your Show integration in Swapcard, it indicates that your credentials are not being accepted by the Map Your Show API. Please reach out to the Map Your Show support team for assistance.
Changelog
Version | Date | Subject |
0.2.0 | 2026-06-17 | Initial sync now covers the full exhibitor history. |
0.1.13 | 2023-11-17 | 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.
Read more