All Collections
Event Builder
Integrations
Third-Party Registration Solutions
Setting Up a MYS (Map Your Show) Integration in Your Event
Setting Up a MYS (Map Your Show) Integration in Your Event
Updated over a week ago

This page contains the setup guide and reference information for the Map Your Show integrations.

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

  1. Navigate to your Event page within the Communities section.

  2. In the left navigation bar, go to Event Builder, then select Integrations.

  3. On the integration selection page, choose Map Your Show from the list of integrations.

  4. To activate the integration, you will need six parameters, and these will be supplied by Map Your Show.

    1. Username

    2. Password

    3. Client ID

  5. Click on Submit.

  6. 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'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 Map Your Show integration supports the following sync modes :

Supported streams

This integration is supporting the following Map Your Show streams

The integration is using /Exhibitors/Modified to retrieve Exhibitor with fromDate and toDate filtering.

Capturing deleted records

The Map Your Show integration does NOT capture deletions for records in the Exhibitors, Contacts streams.

When a record is deleted on Map Your Show, 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 Exhibitor are associated with a Contact on Map Your Show, the integration will replicate these dependencies within Swapcard.

Exhibitors → Contacts

The Map Your Show integration automatically links the Contacts from Map Your Show with their respective Exhibitors from Map Your Show and creates the corresponding Exhibitor Member on Swapcard.

The integration utilizes the contacts field from the Exhibitors stream.

The exhid of Exhibitors is employed as the main identifier to uniquely link records and store them within the Client Id field on the Swapcard side.

For Contacts, the integration is using a combination of exhId and email and stores them within the Client Id field on the Swapcard side.

Streams supporting fields

Exhibitors

Exhibitors Field

Mapping Label

Type

exhid

"Exhibitor ID"

string

package

"Package"

string

exhname

"Company Name"

string

alpha

"Alpha"

string

address1

"Address 1"

string

city

"City"

string

state

"State"

string

zip

"ZIP Code"

string

country

"Country"

string

email

"Email"

string

phone

"Phone"

string

fax

"Fax"

string

website

"Website"

string

description

"Company Presentation"

string

isActive

"Is Active"

string

twitter

"Twitter"

string

linkedin

"LinkedIn"

string

facebook

"Facebook"

string

instagram

"Instagram"

string

logo

"Company logo URI"

string

booth

"Booth Code"

string

pavilion

"Pavilion"

string

hallid

"Hall ID"

string

dimension

"Dimension"

string

boothtype

"Booth Type"

string

hall

"Hall"

string

squareft

"Square Feet"

number

boothtypedisplay

"Booth Type Display"

string

boothtags

"Booth Tags"

string

productCategoryParentId

"Product Category Parent ID"

string

productCategoryId

"Product Category ID"

string

productCategoryName

"Product Category Name"

string

productCategoryDisplay

"Product Category Display"

string

Contacts

Contacts Field

Mapping Label

Type

zip

"Zip Code"

string

lname

"Last Name"

string

phone

"Phone Number"

string

state

"State"

string

email

"Email"

string

fname

"First Name"

string

city

"City"

string

country

"Country"

string

title

"Title"

string

address1

"Address Line 1"

string

fax

"Fax"

string

fullname

"Full Name"

string

address2

"Address Line 2"

string

Limitations & Troubleshooting

Connector limitations

Full Refresh - Overwrite & Intial Sync limited to 30 days

The Full Refresh - Overwrite and initial sync processes are currently limited to retrieving data from the last 30 days due to system constraints. If you require older data, please reach out to Swapcard support for assistance.

Inactive Exhibitors

The connector is intentionally configured not to import exhibitors' data that is pending or not approved, which is identified as isActive: 0 on the MapYourShow platform.

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.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.

Did this answer your question?