Bulk Companies by source id

POST 
/companies/bulk/sourceId

The bulk endpoints offer an efficient way of importing/updating large amounts of companies with just a single API call. When using the bulk sourceId endpoint, the companies are identified by sourceId, source and language. If a company doesn't already exist, it will be created. If it does exist, the company found will be updated.

Company bulk endpoints support bulk change of attributes for multiple companies as well. To learn more about Attributes, go here.

A single company's attributes can be modified as explained in Bulk resource attribute values by resource lookup key, but if it's needed to modify attributes for multiple companies in a single call, this endpoint should be used.

Fields

Name	Required
companies (array of company objects)	yes
source	yes
sourceId	yes
name	no
language	yes
parent	no
taxNumber	no
cocNumber	no
debtorId	no
department	no
office	no
notes	no
inheritProductList	no Default is Y
inheritOrderList	no Default is Y
budget	no Default is N
budgetInherit	no Default is Y
orderListAllowAll	no Default is U
attributes Read more about attributes	no
addresses Read more about addresses	no

Directives

Name	Description	Fields
skipIfNotEmpty	On update, skip updating fields of an existing company that are not empty	array of field names e.g. name, office etc.
skipMoveOnUpdate	On update, skip moving an existing company in the parent provided	empty array

What are directives?

Request

Responses

200

Bulk Companies by source id - 200

Response Headers

Alt-Svc
Via
alt-svc
content-length
date
return-format
x-request-id

400

Bulk Companies by source id - 400 (invalid schema)

Response Headers

Alt-Svc
Via
alt-svc
content-length
date
return-format
x-request-id