MC Trade ➔ Engagefully

Source System: MC Trade
Destination System: Engagefully
Version: 1.2.2026.11100

Description

Imports registrants, and optionally exhibitors, from MC Trade into Engagefully.
An Engagefully event can take several MC Trade events: give it one MC Trade external key per event. Registrants are matched by email address, so a person in more than one of them is imported once.
Every registrant gets the Registrant role. Event roles by MC Trade event adds a role per MC Trade event.
Import exhibitors from these MC Trade events creates one exhibitor per company registered for those events and links registrants to it by company name.
Job title, phone and each address field (lines 1 and 2, city, state, postal code, country) have their own Import ...? switch and come from the registrant's MC Trade profile. MC Trade's attendee list leaves phone and address blank and has fewer titles, so any of them adds one profile request per registrant. Job title is on by default; the rest are off. A field that is off is left untouched in Engagefully. Attendees without a profile get only the job title from their registration.
Attendees without a first name, last name and email are skipped and listed in the job's registrant errors, with their MC Trade attendee and registration IDs.
Use the Get Events API harness endpoint to look up MC Trade event IDs, and Get Profile to see what a registrant's profile holds (take the ProfileId from Get Event Attendees).

Mapping Information

MC Trade		Engagefully	Notes
Attendee	➔	RosterEntry
Email (lowercased)	➔	ExternalKey	One registrant per email address. Someone registered for several of this event's MC Trade events is imported once, with each event's role.
FName	➔	FirstName
LName	➔	LastName
Email	➔	Email
OrgName	➔	Company	Falls back to RegistrationOrgName.
Profile.Title	➔	Title	Configurable (Import job title?, on by default). From GET profile/{ProfileId}, falling back to the attendee search's Title.
Profile.WorkPhone / CellPhone / HomePhone	➔	Phone	Configurable (Import phone?). From GET profile/{ProfileId}, not the attendee search, which returns phone blank. The number named by the profile's PhoneDefault ("Work", "Cell" or "Home"), else work, cell, then home, else the profile named by InheritPhoneFrom.
Profile.Address1	➔	Address1	Configurable (Import address line 1?). From GET profile/{ProfileId}; the attendee search returns address blank. Every address field comes from one profile: the person's own when it has any address, else the profile named by InheritAddressFrom.
Profile.Address2	➔	Address2	Configurable (Import address line 2?). As Address1.
Profile.City	➔	City	Configurable (Import city?). As Address1.
Profile.State	➔	Region	Configurable (Import state?). As Address1, as MC Trade spells it.
Profile.Zip + ZipExt	➔	PostalCode	Configurable (Import postal code?). As Address1. "Zip-ZipExt" when the extension is present.
Profile.Country	➔	Country	Configurable (Import country?). As Address1, as MC Trade spells it.
(static default)	➔	RoleRefs[*] (Registrant = true)
EventId	➔	RoleRefs[*].ExternalKey	Configurable. "{Data Source Name}-event-{EventId}", named by the Event Roles setting.
OrgName	➔	Exhibitor.ExternalKey	When exhibitor events are configured: the exhibitor whose company name matches.

Attendee	➔	Exhibitor
OrgName (normalized)	➔	ExternalKey	"exhibitor-{company}": lowercased, punctuation and extra spaces removed. Only attendees of the configured exhibitor events.
OrgName	➔	Name	Falls back to RegistrationOrgName.