Confirm AWD Departure Destination
POST/api/amazon/:integrationInstance/awd/ledgers/departure-destinations/:awdLedger
Send an AWD outbound-order departure (reference repl-ship-…) to where it actually went: one of your own warehouses (for example a 3PL), or an AWD sales order line for a direct sale. Usually the destination List Unattributed AWD Departures suggested.
Body — exactly one of:
warehouse_id(integer) — a non-Amazon warehouse. Creates (or adds to) the AWD outbound transferAWD-<reference>from your AWD warehouse to it, with a shipment for the departed units; receiving it costs the units at what they cost in AWD.sales_order_line_id(integer) — a sales order line assigned to this account's AWD warehouse, for the same product.
The link is recorded with what was suggested at the time and whether the suggestion was followed, so it can be audited later.
Refused (422) when the departure is not an AWD outbound order, is already linked or already attributed to an FBA shipment, when the warehouse is an Amazon FBA or AWD warehouse, when the product does not match, or when the sales order line already shipped those units from a stock-deducting warehouse. Sending both fields, or neither, is a validation error.
⚠ This LINKS records. It creates no ledger entry and does not change how many units left AWD.
Authentication: requires a Bearer token.
Returns 404 when the AWD ledger entry belongs to a different Amazon account than the one in the URL.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
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 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.