# 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