Create AWD Inbound Order from Plan
POST/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/awd/orders
Create the plan's AWD inbound order at Amazon as a DRAFT from its ready lines (see Get AWD Plan Readiness), and optionally confirm it in the same call. The plan must be verified (status verified, verified with adjustments, configured, or submitted) and its ship-from warehouse must have a complete address.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Idempotent: if the plan already has a live (not cancelled or expired) order, that order is re-read from Amazon and returned instead of creating another, so a retry after a timeout is safe.
Body (all optional):
destination_region(string|null): preferred AWD region,us-west,us-east,us-southcentralorus-southeast; null lets Amazon chooseexternal_reference(string|null, ≤240): your reference on the Amazon order (defaultSKU-IP{plan id}; made unique per account)confirm(boolean, default false): confirm the draft straight away (see Confirm AWD Inbound Order)
When Amazon rejects the draft, the 422 lists per-MSKU errors[] and details.manual_entry (each included line's msku, sku, units, case_pack_qty, cases) plus details.seller_central_url, so the order can be keyed in Seller Central instead. A 409 means another request is creating the same order; wait and re-read the plan.
Errors. A refused action answers with {message, code, errors: [{msku, message, code}], details}: 422 when SKU.io refuses it before calling Amazon (wrong status, plan not ready) or Amazon rejects it (code: rejected); 403 not_authorized when Amazon has not granted the AWD role (reconnect the account); 404 not_found when Amazon no longer knows the order; 409 conflict while Amazon is still validating the order or refuses the change (details.amazon_reason); 429 rate_limited; 504 timeout. A 409, 429 or 504 changed nothing and can be retried.
Requires the integrations.sync permission.
Returns 404 when the plan belongs to a different Amazon account than the one in the URL.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
- 504
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Conflict
Response Headers
Unprocessable Entity
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.
Gateway Timeout