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.
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 |
|
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 |
|
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 |
|
|
|
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 |
|
|
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 |