Create NuORDER Integration
POST/api/nuorder/instances
Creates a NuORDER integration for one brand portal. It is not connected yet: call Request NuORDER Access next.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Body fields:
name(required, unique across all integrations)environment(required):production(next.nuorder.com) orsandbox(sandbox1.nuorder.com). Never defaulted.consumer_key,consumer_secret(required): from NuORDER → Admin → API Management.store_id(optional): the SKU.io store imported orders belong to. Omitted: the account's default store (General Settings → default store, else the oldest store).order_import_start_date(optional, Y-m-d): orders created before this date are not imported.
order_import_start_date cannot be earlier than the account's inventory start date (422 on that field).
A new integration pushes no stock: its stored inventory starts as masterOfStock: Neither with no stock warehouses, and each NuORDER warehouse found later starts as Neither with selectedWarehouses: [] unless a Warehouse Mapping exists for its code (then sku.io, drawing from the mapped warehouses). Choose the stock warehouses in Update NuORDER Integration (inventory.locations).
Request
Responses
- 201
- 401
- 403
- 422
- 429
Created
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.
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.