Skip to main content
Gainsight Inc.

Key Differences Between V1 and V2 Connectors

The article provides the parity gap between the V1 and V2 connectors in terms of fields that are deprecated and newly added.

The article provides the key differences between the V1 and V2 connectors in terms of fields that are deprecated.

Overview

To enhance performance and bring in critical upgrades, some connectors are impacted. As a result, the following connectors need to be re-authorized or jobs need to be recreated to avoid data sync failures and job disruptions.

  • Recreate jobs on V2 Connector: 
    • Zuora
    • Intercom
    • Pipedrive
    • Zoho
  • Re-authorize Connection: 
    • JIRA
    • ServiceNow
    • Freshdesk (“Edit Connection” and “Save”) 
    • Google Big Query
    • Zendesk 

As the connectors are upgraded for our Gainsight framework, Gainsight ensures compatibility with the latest supported API versions from these applications. In some instances, changes in the updated APIs required adjustments to the fields available in the Connector. As a result, some fields were deprecated or removed.

For any fields that are critical for your usecases, Gainsight recommends to reach out to Gainsight Support.

Deprecated and Newly added Fields

Intercom

Object Name Deprecated Field Name Notes

 

 

Customers

companies.companies[0].company_id

 
companies.companies[0].id Renamed to Companies.data[*].id. The response now is in JSON Format
companies.companies[0].name  

 

Conversations

conversation_parts.conversation_parts[0].body  
customers[0].id Renamed to contacts.contacts[*].id. The response now is in JSON Format

Freshdesk

Object Name Deprecated Field Name

 

 

 

 

 

Incidents

attachments[*].attachment_url
attachments[*].content_type
attachments[*].created_at
attachments[*].id
attachments[*].name
attachments[*].size
attachments[*].thumb_url
attachments[*].updated_at
unique_external_id

Object Name : Companies

Change Data Type

createdAt

String → Datetime

renewal_date-

String → Date

Zendesk

Object Name Deprecated Field Name

 

Tickets

fields[*].id

fields[*].value

Pipedrive

Object Name Deprecated Field Name Notes

 

 

Accounts

reference_activities_count  
edit_name  
country_code  

 

 

 

Conversations

phone1.value The fields will be replaced by contacts.phone which will return an array of phone numbers.
email1.value The fields will be replaced by contacts.email which will return an array of emails.
email3.value  
email2.value  
Opportunities stay_in_pipeline_stages.times_in_stages.1  
Users Activated  
accountsMails   Deprecated
contactsMails   Deprecated
opportunitiesMails   Deprecated

Zoho

Object Name Deprecated Field Name Notes

 

 

 

 

 

 

Accounts

 

Brand_Affilliation.name Replaced with Brand_Afflication which now returns the ID. Import lookup to Accounts object can pick the name field.
CS_Coordinator.id Renamed to CS_Coordinator which would now return the ID.
CS_Coordinator.name Replaced with CS_Coordinator which would now return the ID. Import lookup to the User object can pick the name field.
Ownership_Company.name Replaced with Ownership_Company which would now return the ID.
Parent_Account.name Replaced with Parent_Account which would now return the ID. Import lookup to the Accounts object can pick the name field.
Secondary_Contact.name Replaced with Secondary_Contact which now return the ID. Import lookup to the User object can pick the name field.
Deals $review_process.approve Deprecated
Account_Name.name Replaced with Account_Name which would now return the ID. Import lookup to the Accounts object can pick the name field.
Modified_By.email Replaced by Modified_By which would now return the ID. Import lookup to the User object can pick the email field.
Onboarding Contact Name.name Replaced by ContactName which would now return the ID. Import lookup to the User object can pick the name field.

 

  • Was this article helpful?