Skip to main content

Upsert suppliers

POST 
/v1/supplier

Import or update suppliers with locations, addresses, and bank accounts. Supports both incremental updates and full data replacement.

Upsert Key: (supplier_number, organization_code) (ON CONFLICT target)

full_load Behavior:

  • false (default): Incremental upsert — updates existing records (matched by supplier_number + organization_code), inserts new ones
  • true: Full replacement — deletes ALL existing suppliers for the customer, then inserts new data

Additional Options:

  • SupplierAddressInsertOnly: If true, only inserts new addresses without updating existing ones
  • SupplierBankInsertOnly: If true, only inserts new bank accounts without updating existing ones

Required Fields: supplier_number, supplier_name. organization_code is part of the upsert key but not validated as required at the API level — if omitted it falls back to a default and may collide on the natural key.

Request​

Responses​

Suppliers inserted successfully