Update a company

Update an existing company”s attributes, name, linked contacts, or linked deals. Note that passing linkedContactsIds or linkedDealsIds replaces the entire list of associations, so omitted IDs will be removed. The company name cannot be set to an empty string.

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Path parameters

idstringRequired

Request

Updated company details.
attributesobjectOptional
Attributes for company update
countryCodelongOptional

Country code if phone_number is passed in attributes.

linkedContactsIdslist of longsOptional

Warning - Using PATCH on linkedContactIds replaces the list of linked contacts. Omitted IDs will be removed.

linkedDealsIdslist of stringsOptional

Warning - Using PATCH on linkedDealsIds replaces the list of linked deals. Omitted IDs will be removed.

namestringOptional
Name of company

Response

Company updated successfully
attributesobject
Company attributes with values
idstring
Unique company id
linkedContactsIdslist of integers
Contact ids for contacts linked to this company
linkedDealsIdslist of strings
Deal ids for deals linked to this company

Errors

400
Bad Request Error
404
Not Found Error