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 parity gap between the V1 and V2 connectors in terms of fields that are deprecated and newly added.

Overview

To enhance performance and bringing in critical upgrades, some connectors are impacted. As a result, 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 ensured 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, while new fields were introduced.

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

Deprecated and Newly added Fields

Intercom

V1 V2

Object Name: Agents

New Object name: Admins

 

Fields Added

 

job_title

 

has_inbox_seat

Object Name: Companies

Deprecated Fields

Added Fields

custom_attributes.monthly_spend

segments.segments[*].name

custom_attributes.paid_subscriber

tags.tags[*].name

custom_attributes.team_mates

 

plan.type

 

segments.type

 

tags.type

 

Object Name: Customers

New Object Name: Contacts

Deprecated Fields

Added Fields

Anonymous

Android App name

App ID

Android SDK version

Avatar image url

Browser

avatar.type

Browser Language

City

Browser version

companies.companies[*].company_id

Contact role

companies.companies[*].id

Email

companies.companies[*].name

Email Domain

companies.companies[*].type

First Seen

companies.type

Has hard bounced

Continent code

ID

Country

iOS App name

Country code

iOS SDK version

Email

Language Override

Email domain

Last clicked on link in email

First Seen

Last contacted

Has hard Bounced

Last heard from

ID

Last opened email

IP

OS

Latitude

type

location_data.type

Unsubscribed from Emails

Longitude

Updated at

Phone Number Country

User ID

Postal Code

Workspace ID

Pseudonym

 

Referral URL

 

Region

 

remote_created_at

 

segments.segments[*].id

 

segments.segments[*].type

 

segments.type

 

social_profiles.type

 

tags.tags[*].id

 

tags.tags[*].name

 

tags.tags[*].type

 

tags.type

 

Object Name: Conversations

Deprecated Fields

Added Fields

assignee.id

contacts.contacts[*].external_id

assignee.type

contacts.contacts[*].id

conversation_message.author.id

conversation_rating.contact.external_id

conversation_message.author.type

conversation_rating.rating

conversation_message.body

conversation_rating.teammate.id

conversation_message.delivered_as

Count assignments

conversation_message.id

Count conversation parts

conversation_message.subject

Count reopens

conversation_message.type

 

conversation_parts.conversation_parts[*].author.id

First admin reply at

conversation_parts.conversation_parts[*].author.type

First assignment at

conversation_parts.conversation_parts[*].body

First close at

conversation_parts.conversation_parts[*].created_at

First contact reply at

conversation_parts.conversation_parts[*].id

ID

conversation_parts.conversation_parts[*].notified_at

Last admin reply at

conversation_parts.conversation_parts[*].part_type

Last assignment admin reply at

conversation_parts.conversation_parts[*].type

Last assignment at

conversation_parts.conversation_parts[*].updated_at

Last close at

conversation_parts.total_count

Last closed by ID

conversation_parts.type

Last contact reply at

customer_first_reply.created_at

linked_objects.data[*].category

customer_first_reply.type

linked_objects.data[*].id

customers[*].id

linked_objects.data[*].type

customers[*].type

Median time to reply

id

Priority

tags.type

Rating contact ID

updated_at

Rating remark

user.id

sla_applied.sla_name

 

sla_applied.sla_status

 

sla_applied.type

 

Snoozed until

 

Source author email

 

Source author ID

 

Source author name

 

Source author type

 

Source body

 

Source delivered as

 

Source ID

 

Source subject

 

Source type

 

statistics.type

 

Team assignee ID

 

Teammate assignee ID

 

teammates.teammates[*].id

 

Time to admin reply

 

Time to assignment

 

Time to first close

 

Time to last close

 

Title

Freshdesk

V1 V2

Object Name : Tickets

Deprecated Fields

Added Fields

attachments[*].attachment_url

 

attachments[*].content_type

 

attachments[*].created_at

 

attachments[*].id

 

attachments[*].name

 

attachments[*].size

 

attachments[*].thumb_url

 

attachments[*].updated_at

 

deleted

 

email

 

facebook_id

 

name

 

phone

 

twitter_id

 

unique_external_id

 
Object Name : Contacts

Deprecated Fields

Added Fields

 

avatar.avatar_url

 

avatar.content_type

 

avatar.created_at

 

avatar.id

 

avatar.name

 

avatar.size

 

avatar.updated_at

 

deleted

 

other_companies[*].company_id

 

other_companies[*].view_all_tickets

 

other_emails

 

tags

 

twitter_profile_status

 

view_all_tickets

 

Object Name : Agents

Deprecated Fields

Added Fields

email

 

group_ids

 

job_title

 

language

 

mobile

 

name

 

phone

 

role_ids

 

time_zone

 

Object Name : Companies

Change Data Type

Deprecated Fields

Added Fields

   

createdAt

String → Datetime

renewal_date-

String → Date

Zoho

V1 V2

Object Name : Accounts

Deprecated Fields

Added Fields

$approval.approve

 

$approval.delegate

 

$approval.reject

 

$approval.resubmit

 

$approval_state

 

$approved

 

$currency_symbol

 

$editable

 

$followed

 

$in_merge

 

$orchestration

 

$process_flow

 

$review_process.approve

 

$review_process.reject

 

$review_process.resubmit

 

$state

 

Created_By.email

 

Created_By.id (Renamed to Created_By)

 

Created_By.name

 

Modified_By.email

 

Modified_By.id (Renamed to Modified_By)

 

Modified_By.name

 

Owner.email

 

Owner.id (Renamed to Owner)

 

Owner.name

 

Parent_Account.id (Renamed to Parent_Account)

 

Parent_Account.name

 

Tag[*].id

 

Tag[*].name

 

Object Name : Contacts

Deprecated Fields

Added Fields

$approval.approve

 

$approval.delegate

 

$approval.reject

 

$approval.resubmit

 

$approval_state

 

$approved

 

$currency_symbol

 

$editable

 

$followed

 

$in_merge

 

$orchestration

 

$process_flow

 

$review_process.approve

 

$review_process.reject

 

$review_process.resubmit

 

$state

 

Created_By.email

 

Created_By.id (Renamed to Created_By)

 

Created_By.name

 

Modified_By.email

 

Modified_By.id (Renamed to Modified_By)

 

Modified_By.name

 

Owner.email

 

Owner.id (Renamed to Owner)

 

Owner.name

 

Tag[*].id

 

Tag[*].name

 

Vendor_Name.id (Renamed to Vendor_Name)

 

Vendor_Name.name

 

Object Name : Cases

Deprecated Fields

Added Fields

$approval.approve

 

$approval.delegate

 

$approval.reject

 

$approval.resubmit

 

$approval_state

 

$approved

 

$currency_symbol

 

$editable

 

$followed

 

$in_merge

 

$orchestration

 

$process_flow

 

$review_process.approve

 

$review_process.reject

 

$review_process.resubmit

 

$state

 

Account_Name.id (Renamed to Account_Name)

 

Account_Name.name

 

Comments[*].comment_content

 

Comments[*].commented_by

 

Comments[*].commented_time

 

Comments[*].id

 

Created_By.email

 

Created_By.id (Renamed to Created_By)

 

Created_By.name

 

Deal_Name.id (Renamed to Deal_Name)

 

Deal_Name.name

 

Modified_By.email

 

Modified_By.id (Renamed to Modified_By)

 

Modified_By.name

 

Owner.email

 

Owner.id (Renamed to Owner)

 

Owner.name

 

Product_Name.id (Renamed to Product_Name)

 

Product_Name.name

 

Related_To.id (Renamed to Related_To)

 

Related_To.name

 

Tag[*].id

 

Tag[*].name

 

Object Name : Deals

Deprecated Fields

Added Fields

$approval.approve

 

$approval.delegate

 

$approval.reject

 

$approval.resubmit

 

$approval_state

 

$approved

 

$currency_symbol

 

$editable

 

$followed

 

$in_merge

 

$orchestration

 

$process_flow

 

$review_process.approve

 

$review_process.reject

 

$review_process.resubmit

 

$state

 

Account_Name.id (Renamed to Account_Name)

 

Account_Name.name

 

Campaign_Source.id (Renamed to Campaign_Source)

 

Campaign_Source.name

 

Contact_Name.id (Renamed to Contact_Name)

 

Contact_Name.name

 

Created_By.email

 

Created_By.id (Renamed to Created_By)

 

Created_By.name

 

Modified_By.email

 

Modified_By.id (Renamed to Modified_By)

 

Modified_By.name

 

Owner.email

 

Owner.id (Renamed to Owner)

 

Owner.name

 

code (Not part of CE data API but part of attributes call of CE)

 

details.Created_By.id (Not part of CE data API but part of attributes call of CE)

 

details.Created_By.name (Not part of CE data API but part of attributes call of CE)

 

details.Created_Time (Not part of CE data API but part of attributes call of CE)

 

details.Modified_By.id (Not part of CE data API but part of attributes call of CE)

 

details.Modified_By.name (Not part of CE data API but part of attributes call of CE)

 

details.Modified_Time (Not part of CE data API but part of attributes call of CE)

 

details.id (Not part of CE data API but part of attributes call of CE)

 

message (Not part of CE data API but part of attributes call of CE)

 

status (Not part of CE data API but part of attributes call of CE)

 

Object Name : Invoices

Deprecated Fields

Added Fields

$approval.approve

 

$approval.delegate

 

$approval.reject

 

$approval.resubmit

 

$approval_state

 

$approved

 

$currency_symbol

 

$editable

 

$in_merge

 

$line_tax[*].id

 

$line_tax[*].name

 

$line_tax[*].percentage

 

$line_tax[*].value

 

$orchestration

 

$process_flow

 

$review_process.approve

 

$review_process.reject

 

$review_process.resubmit

 

$state

 

Account_Name.id (Renamed to Campaign_Source)

 

Account_Name.name

 

Contact_Name.id (Renamed to Campaign_Source)

 

Contact_Name.name

 

Created_By.email

 

Created_By.id (Renamed to Campaign_Source)

 

Created_By.name

 

Modified_By.email

 

Modified_By.id (Renamed to Campaign_Source)

 

Modified_By.name

 

Owner.email

 

Owner.id (Renamed to Campaign_Source)

 

Owner.name

 

Product_Details

 

Product_Details[*].Discount

 

Product_Details[*].Tax

 

Product_Details[*].id

 

Product_Details[*].list_price

 

Product_Details[*].net_total

 

Product_Details[*].product.Product_Code

 

Product_Details[*].product.id

 

Product_Details[*].product.name

 

Product_Details[*].product_description

 

Product_Details[*].quantity

 

Product_Details[*].quantity_in_stock

 

Product_Details[*].total

 

Product_Details[*].total_after_discount

 

Product_Details[*].unit_price

 

Sales_Order.approve

 

Sales_Order.delegate

 

Sales_Order.id (Renamed to Campaign_Source)

 

Sales_Order.name

 

Sales_Order.reject

 

Sales_Order.resubmit

 

code (Not part of CE data API but part of attributes call of CE)

 

details.Created_By.id (Not part of CE data API but part of attributes call of CE)

 

details.Created_By.name (Not part of CE data API but part of attributes call of CE)

 

details.Created_Time (Not part of CE data API but part of attributes call of CE)

 

details.Modified_By.id (Not part of CE data API but part of attributes call of CE)

 

details.Modified_By.name (Not part of CE data API but part of attributes call of CE)

 

details.Modified_Time (Not part of CE data API but part of attributes call of CE)

 

details.id (Not part of CE data API but part of attributes call of CE)

 

message (Not part of CE data API but part of attributes call of CE)

 

status (Not part of CE data API but part of attributes call of CE)

 

Pipedrive 

V1 V2

New Object

Products

 

Fields Added

 

active_flag

 

add_time

 

files_count

 

first_char

 

update_time

 

product_variations.id

 

product_variations.name

 

product_variations.product_id

 

product_variations.prices[*].id

 

product_variations.prices[*].product_id

 

product_variations.prices[*].product_variation_id

 

product_variations.prices[*].currency

 

product_variations.prices[*].comment

 

product_variations.prices[*].price

 

product_variations.prices[*].price_formatted

Object Name : Activities

Deprecated Fields

Added Fields

calendar_sync_include_context

 

conference_meeting_client

 

is_recurring

 

lead

 

original_start_time

 

Object Name: ActivityTypes

Deprecated Fields

Data type V1

Data type V2

add_time

date

DATETIME

update_time

date

DATETIME

Object Name: Opportunities

Deprecated Fields

Added Fields

local_close_date

 

local_lost_date

 

local_won_date

 

org_id.label_ids

 

Object Name: Notes

Deprecated Fields

Added Fields

lead

 

Object Name: Organization

Deprecated Fields

Added Fields

delete_time

 

Object Name: Contacts

Deprecated Fields

Added Fields

birthday

 

delete_time

 

job_title

 

notes

 

postal_address

 

postal_address_admin_area_level_1

 

postal_address_admin_area_level_2

 

postal_address_country

 

postal_address_formatted_address

 

postal_address_lat

 

postal_address_locality

 

postal_address_long

 

postal_address_postal_code

 

postal_address_route

 

postal_address_street_number

 

postal_address_sublocality

 

postal_address_subpremise

 
  • Was this article helpful?