Start Seller Central Hand-off
POST/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/awd/seller-central-handoff
Finish an AWD plan in Seller Central after Amazon rejected its draft in SKU.io. Returns the reference to type as the shipment name in Seller Central → Send to AWD, and the case groups (packagesToInbound) to enter. The plan's reservation and draft transfer are synced to those packages and stay held.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
When the shipment sync later sees an order SKU.io doesn't know, it is linked to this plan (order source: handoff) if its externalReferenceId equals the reference, or, when no reference was typed, if its units per MSKU equal these packages and it was created after the hand-off. Only an unambiguous match (one plan) is linked. A hand-off with no order after 90 days releases the reservation, cancels the plan and raises an "AWD Seller Central Hand-off Expired" alert.
Calling it again keeps the same reference. The plan's awd_handoff (on the plan resource) shows the pending hand-off.
Refused (422) for a plan that does not ship to AWD, is cancelled, already has a live AWD order (code: awd_order_live), has no SKU ready for AWD, or whose source can't cover the reservation (code: insufficient_stock). 409 (code: awd_plan_busy) while another create, update or confirm on the plan is running.
Requires the integrations.update permission.
Returns 404 when the plan belongs to a different Amazon account than the one in the URL.
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.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
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.