How do I integrate Grip Manage and Grip Engage?

In this article, we'll cover the integration configuration between Grip Manage and Grip Engage.

What you'll learn in this article: 

  1. How to configure the Manage <> Engage configuration
  2. What you need to configure ahead of starting the integration
  3. Commonly asked questions related to the integration 

Understanding The Manage <> Engage integration

Grip Manage and Grip Engage are two distinct platforms that can be tightly integrated to sync all critical data between the two systems. 

The purpose of being able to configure this as there are distinct use cases for your event management platform and event engagement platform on how you want data to be used in both solutions.

Before you start configuring the integration

Make sure that the following configuration has been completed ahead of starting with the integration:

  1. You've created the Event on both the Grip Manage and Grip Engage platform
  2. All your desired Pass Types are present in Grip Manage and Data Types in Grip Engage
  3. All your Registration Questions are configured in Grip Manage and corresponding Custom Profile Fields are configured in Grip Engage.
    1. Note: the integration will not create Custom Profile Fields in Grip Engage so it's critical that you configure those if you want to map the data.

How to configure the integration

General Integration Details

Starting with the "General Integration" details, go to the "Integrations" page on Grip Manage and navigate to the integration section. 

Field What to fill in and where to find it
API Key Login to Grip Engage and go to "Access Token" and use your users token as the API Key.
API Base URL This is always "https://api-prod.grip.events/1/"
Container ID This is your Grip Engage "Container / Event ID"
Web URL This is your event URL in Grip Enage

 

Participant Integration Details

Field What to fill in and where to find it
Participant Integration Status You can choose to enable or disable the participant integration with this toggle.
Click to Connect ID Key Create a single-event field called "Click to Connect ID" in and assign it to all data types and copy the field system name in here such as "app-541-event-7592-click_to_connect_id-1"
Cancellation Type Create a Data Type on Grip Engage called "Cancelled Tickets" and fill in the Type ID here. And remove all permissions for this data type in Grip Engage. All cancelled tickets will automatically be assigned to this data type.
Participant Field Mapping

Here you map the Registration Questions of Grip Manage to the Custom Fields in Grip Engage.

Note that you can see under 'default field mapping' the fields that cannot be configured and that are mapped as standard.

Pass Types Mapping Here you map the pass types of Grip Manage to the Participant Data Types of Grip Engage.


Participant Field Mapping Example: 

Pass Types Mapping Example:

Company Integration Details

Field What to fill in and where to find it
Company Integration Status You can choose to enable or disable the company integration with this toggle.
Sponsor Company Type

Specify the Company Data Type in Grip Engage that all companies in Grip Manage should be mapped into.

Note that you can see under 'default field mapping' the fields that cannot be configured and that are mapped as standard.

Company Field Mapping As you did for participants, map the company fields from Grip Manage to Grip Engage.

Session Integration Details

Field What to fill in and where to find it
Event Agenda Integration Status

You can choose to enable or disable the event agenda integration with this toggle.

Note that you can see under 'default field mapping' the fields that cannot be configured and that are mapped as standard.

Event Agenda Field Mapping As you did for participants and companies, this is where you can map event agenda fields from Grip Manage into Grip Engage.