Update NuORDER Integration
PUT/api/nuorder/instances/:integrationInstance
Updates settings. Every field is optional; send only what changes. Nested inventory and fulfillment objects are merged; warehouse_mappings is replaced whole.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Fields: name, is_automatic_sync_enabled, store_id, order_import_start_date (Y-m-d), create_orders_at_status (approved or pending), acknowledge_orders (move imported orders to processed in NuORDER), write_back_external_id (write the SKU.io order number to NuORDER's external ID), auto_match_on_import, auto_create_products, default_warehouse_id, warehouse_mappings (object: NuORDER warehouse code → array of SKU.io warehouse IDs), emailCustomers (SKU.io sends its own "your order has shipped" email to the retailer), fulfillment.suppress_emails (stop NuORDER's own shipment email to the retailer — with both on, the retailer gets two emails), fulfillment.send_cancellations, inventory.locations[] (one per NuORDER warehouse; the array replaces the stored one): externalLocationId (NuORDER warehouse code, required), masterOfStock (sku.io or Neither, required), selectedWarehouses[] (SKU.io warehouse IDs whose stock is offered — starts from the Warehouse Mappings entry but can be any warehouses), inventoryModificationRules (maxRuleType / minRuleType: None, Fixed Allocation or % of Available, with maxRuleTypeValue / minRuleTypeValue; subtractBufferStock), inventory.futureAtsEnabled, inventory.futureAtsHorizonDays (1–730).
A NuORDER warehouse that was never saved starts from its Warehouse Mappings entry (sku.io, drawing from the mapped warehouses), else Neither with no stock warehouses. Saving inventory.locations also sets the portal-wide inventory.masterOfStock that the shared channel inventory and listings views read: sku.io when any location is sku.io, else Neither.
Marketplace fulfillment warehouses (Amazon FBA / AWD, Walmart WFS, Faire FBF, TikTok Shop FBT) cannot be used: any of them in warehouse_mappings.* or inventory.locations.*.selectedWarehouses returns 422 on that field.
order_import_start_date cannot be earlier than the account's inventory start date (422 on that field).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.