This integration uses the YourMembership (YM) REST API to connect a Higher Logic Thrive Community (Thrive Community) to a YourMembership site.

NOTE: YourMembership requires its customers to license the REST API from them before Higher Logic can connect. For questions about accessing the YourMembership REST API, contact your YourMembership account representative.

Data mappings

ReadContacts uses the MemberProfile endpoint in YourMembership.
ReadContact uses the People endpoint in YourMembership.

A PeopleResponse is converted to MemberProfile by the Middle to simplify mapping. ReadContacts does not currently sync HeadshotImageURI or QueuedForDelete because these are not available from the MemberProfile endpoint, but these fields exist on the MemberProfile class in the plugin to permit ReadContact to sync them.

Contact

Field Name	YM Person Field	YM MemberProfile Field
Alternative Contact ID	MemberPersonalInfo.ConstituentID	ConstituentID
Age	null	null
Birthday	MemberPersonalInfo.BirthdayDate	Birthdate
Member Since	MemberAccountInfo.ApprovalDate	DateApproved
Member Expires On	MemberAccountInfo.MembershipExpiresDate	DateMembershipExpires
Designation	null	null
Primary Email Address	MemberPersonalInfo.Email	EmailAddress
Prefix Code	MemberPersonalInfo.Prefix	MemberNameTitle
First Name	MemberPersonalInfo.FirstName	FirstName
Middle Name	MemberPersonalInfo.MiddleName	MiddleName
Last Name	MemberPersonalInfo.LastName	LastName
Informal Name	MemberPersonalInfo.NickName	Nickname
Gender	MemberPersonalInfo.Gender	Gender
Ethnicity	null	null
Suffix Code	MemberPersonalInfo.Suffix	MemberNameSuffix
OrganizationName	MemberProfessionalInfo.EmployerName	EmployerName
Title	MemberProfessionalInfo.WorkTitle	ProfessionalTitle
Parent Contact Id	null	null
Primary Contact Contact Id	null	null
Exclude From Directory	!(Is Member)	!(Is Member)
Do Not Email	MemberAccountInfo.EmailBounced	EmailBounced
Is Member	MemberAccountInfo.Approved && !MemberAccountInfo.Suspended && MemberAccountInfo.MembershipExpiresDate > _now	ApprovedSiteMember && !MemberSuspended && DateMembershipExpires > _now
Is Organization	false	false
Bio	null	null
Website URL	MemberProfessionalInfo.WorkUrl	EmployerWebsite
Profile Image URL	MemberPersonalInfo.HeadshotImageURI	null
Facebook URL	null	null
LinkedIn URL	null	null
Blogger URL	null	null
Twitter URL	null	null
Other Social URL	null	null

Contact Phone (Home)

Field Name	YM Person Field	YM MemberProfile Field
Formatted Number	MemberPersonalInfo.HomePhoneAreaCode + MemberPersonalInfo.HomePhoneNumber	HomePhoneAreaCode + HomePhone
Phone Type	“Home”	“Home”

Contact Phone (Mobile)

Field Name	YM Person Field	YM MemberProfile Field
Formatted Number	MemberPersonalInfo.HomeFaxAreaCode + MemberPersonalInfo.HomeFaxNumber (this is correct, it is mislabeled in the People API)	MobileAreaCode + MobilePhone
Phone Type	“Mobile”	“Mobile”

Contact Phone (Work)

Field Name	YM Person Field	YM MemberProfile Field
Formatted Number	MemberProfessionalInfo.WorkPhoneAreaCode + MemberProfessionalInfo.WorkPhoneNumber	EmployerPhoneAreaCode + EmployerPhone
Phone Type	“Work”	“Work”

Contact Phone (Fax)

Field Name	YM Person Field	YM MemberProfile Field
Formatted Number	MemberPersonalInfo.WorkFaxAreaCode + MemberPersonalInfo.WorkFaxNumber	EmployerFaxAreaCode + EmployerFax
Phone Type	“Fax”	“Fax”

Contact Email (Primary)

Field Name	YM Person Field	YM MemberProfile Field
EmailAddress	MemberPersonalInfo.Email	EmailAddress
EmailType	“Primary”	“Primary”
IsPreferred	true	true
DoNotPublish	null	null

Contact Email (Alternate)

Field Name	YM Person Field	YM MemberProfile Field
EmailAddress	MemberPersonalInfo.EmailAlt	EmailAddressAlternate
EmailType	“Alternate”	“Alternate”
IsPreferred	false	false
DoNotPublish	null	null

Contact Address (Home)

Field Name	YM Person Field	YM MemberProfile Field
Address Line 1	MemberPersonalInfo.HomeAddressLine1	HomeAddressLine1
Address Line 2	MemberPersonalInfo.HomeAddressLine2	HomeAddressLine2
Address Line 3	null	null
City	MemberPersonalInfo.HomeAddressCity	HomeCity
State/Province	MemberPersonalInfo.HomeAddressLocation	HomeLocation
Postal Code	MemberPersonalInfo.HomeAddressPostalCode	HomePostalCode
Country Code	MemberPersonalInfo.HomeAddressCountry	HomeCountry

Contact Address (Work)

Field Name	YM Integration Field	YM MemberProfile Field
Address Line 1	MemberProfessionalInfo.WorkAddressLine1	EmployerAddressLine1
Address Line 2	MemberProfessionalInfo.WorkAddressLine2	EmployerAddressLine2
Address Line 3	null	null
City	MemberProfessionalInfo.WorkAddressCity	EmployerCity
State/Province	MemberProfessionalInfo.WorkAddressLocation	EmployerLocation
Postal Code	MemberProfessionalInfo.WorkAddressPostalCode	EmployerPostalCode
Country Code	MemberProfessionalInfo.WorkAddressCountryCode	EmployerCountry

Contact Demographic (From Custom Fields)

Field Name	YM Integration Field
Data Type	pick \| datetime \| text
Demographic Type Id	fieldMetadata.MetadataId
Demographic Type Value	fieldMetadata.DisplayName
Demographic Text Value	MemberCustomFieldResponse.Value (text/datetime) metadataOption.Label (pick)
Demographic Id	MemberCustomFieldResponse.Value (text/datetime) metadataOption.Value (pick)

Contact Group

From Custom Field

Field Name	YM Integration Field
Group Id	fieldMetadata.MetadataId-fieldValueIndex (Multiselect Dropdown) fieldMetadata.MetdatadId-fieldValue (Dropdown)
Group Name	metadataOption.Label
Group Type	“Custom Field”
Group Sub Type	fieldMetadata.FieldName
Role	“Member”
Initial Join Date	null
Begin Date	null
End Date	null

From YM Member Group

Field Name	YM Integration Field
Group Id	ymGroup.GroupID
Group Name	ymGroup.GroupName (before colon)
Group Type	“Group”
Group Sub Type	ymGroup.GroupName (after colon)
Role	“Member”
Initial Join Date	null
Begin Date	null
End Date	null

From YM Membership

Field Name	YM Integration Field
Group Id	“membership-{MemberAccountInfo.Membership.Slugify()}”
Group Name	MemberAccountInfo.Membership
Group Type	“Membership”
Group Sub Type	null
Role	“Member”
Initial Join Date	null
Begin Date	null
End Date	MemberAccountInfo.MembershipExpiresDate

From YM MemberType

Field Name	YM Integration Field
Group Id	MemberAccountInfo.MemberTypeCode
Group Name	MemberAccountInfo.MemberTypeCode
Group Type	“Security”
Group Sub Type	null
Role	“Member”
Initial Join Date	null
Begin Date	null
End Date	MemberAccountInfo.MembershipExpiresDate

From YM Event Registration

Field Name	YM Integration Field
Group Id	ymEvent.EventId
Group Name	ymEvent.Name
Group Type	“Meeting”
Group Sub Type	null
Role	“Member”
Initial Join Date	null
Begin Date	null
End Date	null

Meetings

Field Name	YM Integration Field
Meeting Id	EventId
Title	Name
Description	Description
MeetingType	““
SubType	““
TimeZone	DateTimeOffset (converted to TZI.StandardName)
Price	““
PriceAlternative	““
Location	Location.Name
AddressLine1	Location.Address1
AddressLine2	Location.Address2
AddressLine3	““
City	Location.City
State	Location.State OR Location.Province (if State is null/empty)
PostalCode	Location.PostalCode
Country	Location.Country.CountryName
RegistrationURL	““
DetailsURL	““
BeginDate	StartDate and StartTime (converted to UTC)
EndDate	End Date and EndTime (converted to UTC)
PublishOn	ActiveOn
RegistrationOpenDate	Registration.OpenOnlineRegistrationDateTime
RegistrationCloseDate	Registration.RegisterBy
RegistrationDateAlternative	null
IsBreakout	null

YourMembership (REST API) Integration Guide