Skip to main content

Bulk Companies by Id

POST 

/companies/bulk/id

The bulk endpoints offer an efficient way of importing/updating large amounts of companies with just a single API call. When using the bulk id endpoint, the companies are identified by id. If a company with such id 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

NameRequired
companies (array of company objects)yes
idyes
nameno
languageno
parentno
taxNumberno
cocNumberno
debtorIdno
departmentno
officeno
notesno
inheritProductListno

Default is Y
inheritOrderListno

Default is Y
budgetno

Default is N
budgetInheritno

Default is Y
orderListAllowAllno

Default is U
sourceIdno
sourceonly when sourceId is provided
attributes

Read more about attributes
no
addresses

Read more about addresses
no

Directives

NameDescriptionFields
skipIfNotEmptyOn update, skip updating fields of an existing company that are not emptyarray of field names
e.g. name, office etc.
skipMoveOnUpdateOn update, skip moving an existing company in the parent providedempty array

What are directives?

Request

Responses

Bulk Companies by Id - 200

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