Key Differences Between V1 and V2 Connectors
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 | |
| conversation_message.id | Renamed to source.id | |
| conversation_message.author.id | Renamed to source.author.id | |
| conversation_message.type | Renamed to source.type | |
| conversation_message.delivered_as | Renamed to source.delivered_as | |
| conversation_message.subject | Renamed to source.subject | |
| conversation_message.body | Renamed to source.body | |
| conversation_message.author.type | Renamed to source.author.type | |
| conversation_message.author.name | Renamed to source.author.name | |
| conversation_message.author.email | Renamed to source.author.email |
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. |