Platform Integrations & API

What are platform integrations?

This feature allows institutions to connect their Mainstay data to a third-party platform, such as a Customer Relationship Management system (CRM) or Student Information System (SIS). This enables a 2-way sync of contact record data, including default fields (name, phone, email, etc.) and custom fields created by the partner.

Once an integration instance is configured, this acts as a "set it and forget it" feature. That is, whenever you save a change to a contact in Mainstay or the connected platform, that data can be automatically synced across to the other platform.

Mainstay also offers a public REST API. Documentation is available at https://docs.api.mainstay.com.

View available platforms

1. Log in to the Mainstay platform and navigate to the Settings tool in the navigation bar.
2. Under Third Party Integrations, click on the Browse Available option in the sidebar. This shows the list of currently available third-party platforms.
3. To set up a configuration, click the Learn More button for the specific platform.
4. See these Zendesk articles for more information:
   • Mainstay Sync for Salesforce
   • Mainstay Sync for Hubspot
   • Mainstay Sync for Slate
   • Mainstay Sync for Ellucian Colleague
   • Mainstay Sync for SFTP (including Ellucian Recruit and Ellucian Banner)
   • Mainstay Conversations Export

View error logs

1. In the side bar, click Sync Log, or visit https://app.mainstay.com/settings/sync-log.
2. This table presents a list of errors encountered while attempting to sync data between Mainstay and third-party platforms. Each log includes the following fields:
   • timestamp
   • id
   • integration (ie, which platform)
   • direction (incoming or outgoing)
   • contact (a link to the Contact page of the affected individual)
   • log message (ie, error code)
3. If you encounter data validation errors while importing contact records, visit the Import Error Dictionary to better understand next steps.

Tips

• Contact records that are designated Test Users will be ignored by platform integrations. See Test Users.
• If a contact record is Archived, reimporting that contact via CSV upload or platform integration will un-archive the contact.
• If a contact record does not have a value for a particular field, that field will not be sent for that contact record in outgoing requests. Similarly, when importing information, if the value for a field is blank or null, it will be skipped.
• However, like the Mainstay API and CSV upload, these platform integrations do support clearing the value of all custom fields and the following default fields. Set the field to UNSET (all capitals) and the value will be cleared out.
  • First Name
  • Last Name
  • Preferred Name
  • Phone
  • Email
  • Enrollment ID
  • CRM ID