Transition Guides

HubSpot

Hubspot release notes

HubSpot v 7.0

New endpoints

1. Create call engagement
2. List call engagement dispositions
3. List call engagement dispositions DDL
4. List call engagement properties DDL
5. List call engagements
6. List call engagements DDL
7. Update call engagement
8. Create meeting engagement
9. List meeting engagement properties DDL
10. List meeting engagements
11. List meeting engagements DDL
12. Update meeting engagement
13. Create task engagement
14. List task engagement properties DDL
15. List task engagements
16. List task engagements DDL
17. Update task engagement
18. Create email engagement
19. List email engagement properties DDL
20. List email engagements
21. List contacts of company by ID
22. Create note engagement
23. List note engagement properties DDL
24. List note engagements
25. Update note engagement
26. Delete company
27. Search companies by website
28. List contacts of company by company ID (generic search endpoint)
29. List ticket pipeline stages
30. Delete associations from CRM objects
31. List CRM object associations
32. List association definitions

Updated operations

list_companies

• Updated to the latest API version.
• Input schema changed:
• Removed: required count & offset
• Added: new required limit field, and optional properties_with_history, associations, archived, after and include_all_properties fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower list_company_properties
• Updated to the latest API version
• Input schema changed:
  • Added: optional archived field
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower list_contact_properties
• Updated to the latest API version
• Input schema changed:
  • Added: optional archived field
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower list_line_items
• Updated to the latest API version.
• Input schema changed:
  • Removed: required offset field
• Added: new required limit field, and optional properties_with_history, associations, archived, after, and include_all_properties fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower list_owners
• Updated to the latest API version.
• Input schema changed:
  • Removed: required include_inactive field
  • Added: new required limit field, and optional archived, and after fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower list_products
• Updated to the latest API version.
• Input schema changed:
  • Removed: required offset field
  • Added: new required limit field, and optional properties_with_history, associations, archived, after fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower find_contact_by_email
• Renamed to get_contact_by_email
• Input schema changed:
  • required contact_email field was replaced by a required email field
  • Removed: optional property_mode, form_submission_mode, **show_list_memberships **fields
  • Added: include_all_properties optional field
  • Using the generic search endpoint
  • Output schema changed
• [BREAKING] for users on connector v3.11 or lower find_contact_by_id
• Renamed to get_contact_by_id
• Updated to the latest API version
• Input schema changed:
  • Removed: optional property_mode, form_submission_mode, show_list_memberships fields
  • Added: optional properties_with_history, associations, **archived, include_all_properties **fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower batch_create_update_contact
• Input schema changed: id and email fields were replaced by a single required contact_identifier field
• [BREAKING] for users on connector v3.11 or lower create_contact
• Updated to the latest API version
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower create_crm_contact
• Operation was removed
• [BREAKING] for users on connector v6.0 or lower list_recent_contacts
• Reintroduced get_contact_list
• Input schema changed: id was replaced by contact_list_id
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower delete_contact
• Updated to the latest API version
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower list_contacts
• Updated to the latest API version
• Input schema changed:
  • Removed: required offset field, and optional property_mode, form_submission_mode, show_list_memberships fields
  • Added: new required limit field, and optional properties_with_history, associations, archived, include_all_properties fields
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower list_crm_contacts
• Operation was removed
• [BREAKING] for users on connector v6.0 or lower update_crm_contact
• Renamed to update_contact
• Updated to the latest API version
• Input schema changed:
  • Removed: company, email, firstname, lastname, phone, and website optional fields
  • Added: required properties field
  • All contact properties can be updated now
• [BREAKING] for users on connector v6.0 or lower create_line_item
• Updated to the latest API version
• Input schema changed:
  • Removed: required product_id field, and property_name and property_value from properties
  • Added: name and value to properties
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower get_line_item
• Updated to the latest API version
• Input schema changed:
  • Removed: optional include_delete_properties
  • Added: optional associations, archived, and include_all_properties fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower delete_line_item
• Updated to the latest API version update_line_item
• Updated to the latest API version
• Input schema changed:
  • Removed: property_name and property_value from properties
  • Added: property_name and property_value from properties, and optional property_id field
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower create_group_of_line_items
• Renamed to batch_create_line_items
• Updated to the latest API version
• Input schema changed:
  • Removed: property_name and property_value from properties
  • Added: name and value to properties
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower delete_group_of_line_items
• Renamed to batch_delete_line_items
• Updated to the latest API version
• [BREAKING] for users on connector v3.11 or lower update_group_of_line_items
• Renamed to batch_update_line_items
• Updated to the latest API version
• Input schema changed:
  • Removed: property_name and property_value from properties
  • Added: name and value to properties
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower list_group_of_line_items
• Updated to the latest API version
• Input schema changed:
  • Removed: include_deleted_properties
  • Added: optional property_id field
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower create_company
• Updated to the latest API version
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower get_company
• Updated to the latest API version
• Input schema changed:
  • Added: optional properties, properties_with_history, associations, **archived, property_id **and include_all_properties fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower find_company_by_domain
• Renamed to search_companies_by_domain
• Updated to the latest API version
• Input schema changed:
  • Added: optional properties and after fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower update_company
• Updated to the latest API version
• Input schema changed:
  • Removed: company_properties
  • Added: required properties, and optional property_id
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower associate_crm_object
• Updated to the (latest) API version v4
• Input schema changed:
  • Removed: definition_id
  • Added: object_type, to_object_type, association_category and association_type_id in the advanced properties
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower create_custom_object
• Input schema changed:
  • Updated: Object ID renamed to Custom object record ID delete_custom_object_association
• Input schema changed:
  • Updated: Object ID renamed to Custom object record ID update_custom_object
• Input schema changed:
  • Updated: Object ID renamed to Custom object record ID list_changes_for_products
• Input schema unchanged.
• Output schema changed.
• API version not changed create_group_of_products
• Renamed to batch_create_products
• Updated to the latest API version
• Input schema changed:
  • Removed: required properties2(property_name, property_value) field
  • Added: required product_properties(name, value) field
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower delete_a_group_of_products
• Renamed to batch_delete_products
• Updated to the latest API version
• Input schema changed:
  • Removed: required products field
  • Added: required product_ids field
• [BREAKING] for users on connector v3.11 or lower list_group_of_products
• Renamed to list_products_by_id
• Updated to the latest API version
• Input schema changed:
  • Removed: Required products field and optional properties2, include_deleted_properties fields
  • Added: new required product_ids field, and optional properties, property_id fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower update_group_of_products
• Renamed to batch_update_products
• Updated to the latest API version
• Input schema changed:
  • Removed: required properties2(property_name, property_value) field
  • Added: required product_properties(name, value) field
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower add_contact_to_company
• Updated to the latest API version.
• Input schema changed:
  • Added: required contact_id and company_id field
• Output schema changed.
• [BREAKING] for users on connector v3.11 or lower get_batch_by_vid
• Renamed to list_contacts_by_contact_id
• Updated to the latest API version.
• Input schema changed:
  • Added: required contact_ids field and optional query_properties, properties_with_history, contact_property_id fields
• Output schema changed.
• [BREAKING] for users on connector v3.11 or lower get_batch_by_email
• Renamed to list_contacts_by_email
• Input schema changed:
  • Added: required emails field and optional property, property_mode, form_submission_mode, show_list_memberships, batch_include_deleted fields
• Output schema changed.
• [BREAKING] for users on connector v6.0 or lower search_contacts
• Updated to the latest API version.
• Input schema changed:
  • Added: optional search_contact_filters, search_contacts_query, query_properties, search_contacts_sorts, after, limit fields
• Output schema changed.
• [BREAKING] for users on connector v6.0 or lower list_pipeline
• Updated to the latest API version.
• Input schema changed:
  • Removed: optional include_inactive_pipelines field
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower list_changes_for_line_items
• API version not changed
• Input schema changed:
  • Removed: optional object_id field
  • Added: optional line_item_id field
• Output schema unchanged
• BREAKING] for users on connector v3.11 or lower batch_update_companies
• Updated to the latest API version
• Input schema changed:
  • Added: required companies field
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower add_contact_to_list
• API version not changed
• Input schema changed:
  • Removed: required list_id
  • Added: required contact_list_id
• Output schema unchanged
• [BREAKING] for users on connector v3.11 or lower create_deal
• Updated to the latest API version
• Input schema changed:
  • Removed: optional associations field
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower delete_deal
• Updated to the latest API version
• Input schema unchanged
• Output schema unchanged get_deal
• Updated to the latest API version
• Input schema changed:
  • Added: new optional include_all_properties, properties, properties_with_history, associations, archived and property_id fields
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower list_deals
• Updated to the latest API version
• Input schema changed:
  • Removed: required offset field, and optional deal_properties, include_associations fields
  • Added: new optional include_all_properties, properties, associations, after, archived fields
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower update_deal
• Updated to the latest API version
• Input schema changed:
  • Added: new optional property_id field
• Output schema changed
• [BREAKING] for users on connector v6.0 or lower list_recently_created_deals
• Using the generic search endpoint
• Input schema changed:
  • Removed: required offset field, and optional **since, include_property_versions **fields
  • Added: optional properties and after fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower list_recently_modified_deals
• Using the generic search endpoint
• Input schema changed:
  • Removed: required offset field, and optional since, include_property_versions fields
  • Added: optional properties and after fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower create_ticket
• Updated to the latest API version.
• Input schema changed:
  • Removed: required pipeline_id and stage fields, and optional additional_properties field
  • Added: new required ticket_pipeline_id, ticket_pipeline_stage fields, and optional properties field
• Output schema changed.
• [BREAKING] for users on connector v3.11 or lower

---

delete_ticket

• Updated to the latest API version.
• Input schema unchanged.
• Output schema unchanged.

---

get_ticket

• Updated to the latest API version.
• Input schema changed:
  • Removed: optional properties2, include_delete_properties
  • Added: optional properties, associations, archived, and property_id fields
• Output schema changed.
• [BREAKING] for users on connector v3.11 or lower update_ticket
• Updated to the latest API version
• Input schema changed:
  • Removed: optional properties2 field
  • Added: optional properties and property_id fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower list_tickets
• Updated to the latest API version.
• Input schema changed:
  • Removed: required offset field, and optional properties2 field
  • Added: required limit field, and optional properties, archived, after fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower create_product
• Updated to the latest API version
• Input schema changed:
  • Removed: required properties2(property_name, property_value) field
  • Added: required properties(name, value) field
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower delete_product
• Updated to the latest API version
• Input schema unchanged
• Output schema unchanged get_product
• Updated to the latest API version.
• Input schema changed:
  • Removed: optional properties2, include_delete_properties
  • Added: new optional properties, associations, archived, property_id fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower update_product
• Updated to the latest API version
• Input schema changed:
  • Removed: optional properties2(property_name, property_value)
  • Added: new optional properties(name, value), property_id fields
• Output schema changed
• [BREAKING] for users on connector v3.11 or lower Pagination:
• Max limit of operations with optional Properties with history input field:
  • Request with the Properties with history: Max limit 50
  • Request without the Properties with history: Max limit 100