Update Company (by id)

PUT {{base_url}}/company/v2/companies/:companyId

The ‘Update company’ endpoint will let you update a specific company’s details when the company id is passed as a parameter.

Path variables

FieldTypeDescription
companyIdstringUnique identifier for the company

Attributes

Field NameTypeDescription
namestringCompany name
addressstringRegistered address of the company
websitestringWebsite (www.smewebsite.com)
industrystringIndustry name
descriptionstringCompany description
externalIdstringExternal ID that a partner may want to use to identify a company
crnstringCompanies house number; specific to companies registered with Companies house in the UK

Success

204 No content

Error messages

ConditionResponse StatusResponse Body
Without company id403 Forbidden{“error”: “Invalid request”, “hint”: “Unsupported method or endpoint”}
Invalid company id404 Not Found

Request Body

{"externalId"=>"3456"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
X-Api-Keystring
X-Partner-Idstring
Authorizationstring