{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/carriers/amazon-buy-shipping","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/carriers/amazon-buy-shipping","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/carriers/amazon-buy-shipping","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Amazon Buy Shipping","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"amazon-buy-shipping","__idx":0},"children":["Amazon Buy Shipping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping provides domestic shipping services via your Amazon Seller account and can be used for all Merchant Fulfilled Network orders, including Amazon Prime orders. ShipStation API supports connecting Amazon Buy Shipping accounts for merchants based in the US and UK."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This carrier integration works mostly the same as any other carrier in ShipStation API. However, in some cases, Amazon-specific requirements necessitate a few extra steps."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_name"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amazon_shipping"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both rate and label requests for Amazon Buy Shipping must include some additional data in the request body:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specify the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_source_code"]}," as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amazon"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items"]}," object to include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_order_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_order_item_id"]}," properties, which map to the order ID and order item ID in Amazon Seller Central, respectively."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Match the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_to"]}," property to the address of the order in Amazon Seller Central.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Please note that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_to"]}," address is required, but the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["actual"]}," address used for rating comes from the Amazon order."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-amazon-buy-shipping","__idx":2},"children":["Connect Amazon Buy Shipping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your Amazon Buy Shipping account must be connect in your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://dashboard.shipengine.com/"},"children":["account Dashboard"]},". You cannot currently connect an Amazon Buy Shipping account via endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.shipengine.com/hc/en-us/articles/7534756493595"},"children":["See our Amazon Buy Shipping API help guide"]}," for steps to connect in the ShipStation API Dashboard."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rates","__idx":3},"children":["Rates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping supports ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/rates/rates"},"children":["rate shopping"]}," with ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-rate-request","__idx":4},"children":["Example Rate Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here is an example of how to retrieve Amazon Buy Shipping rates for an Amazon order."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/rates/"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/rates HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"rate_options\": {\n    \"carrier_ids\": [\n      \"se-13395\"\n    ]\n  },\n  \"shipment\": {\n    \"ship_to\": {\n      \"address_residential_indicator\": \"unknown\",\n      \"name\": \"John Smith\",\n      \"phone\": \"555-555-5555\",\n      \"company_name\": \"\",\n      \"address_line1\": \"4301 Bull Creek Rd\",\n      \"address_line2\": \"\",\n      \"address_line3\": \"\",\n      \"city_locality\": \"Austin\",\n      \"state_province\": \"TX\",\n      \"postal_code\": \"78731\",\n      \"country_code\": \"US\"\n    },\n    \"ship_from\": {\n      \"address_residential_indicator\": \"unknown\",\n      \"name\": \"Stamps.com\",\n      \"phone\": \"1-800-608-2677\",\n      \"company_name\": \"\",\n      \"address_line1\": \"1990 E. Grand Ave.\",\n      \"address_line2\": \"\",\n      \"address_line3\": \"\",\n      \"city_locality\": \" El Segundo\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"90245-5013\",\n      \"country_code\": \"US\"\n    },\n    \"packages\": [\n      {\n        \"weight\": {\n          \"unit\": \"pound\",\n          \"value\": 1.0\n        },\n        \"dimensions\": {\n          \"unit\": \"inch\",\n          \"length\": 4.0,\n          \"width\": 3.0,\n          \"height\": 2.0\n        }\n      }\n    ],\n    \"order_source_code\": \"amazon\",\n    \"items\": [\n      {\n        \"quantity\": 1,\n        \"name\": \"Paperback Book\",\n        \"external_order_id\": \"111-7115183-3994627\",\n        \"external_order_item_id\": \"36324373407274\"\n      }\n    ]\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll receive a standard rate response in return."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"service-details","__idx":5},"children":["Service Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The services available will depend on the carriers and services configured in your Amazon seller account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"shipping-from-great-britain-to-northern-ireland","__idx":6},"children":["Shipping from Great Britain to Northern Ireland"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon has confirmed there will be no changes required when shipping from Great Britain to Northern Ireland to comply with the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/windsor-framework"},"children":["Windsor Framework"]}," that goes into effect 1 May 2025. No additional properties will need to be added to your shipment or label requests."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"return-services","__idx":7},"children":["Return Services"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping does not support creating return labels with ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"label-support","__idx":8},"children":["Label Support"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Label sizes: 4\" x 6\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Label formats: PDF, ZPL"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-label-request","__idx":9},"children":["Example Label Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/labels"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's an example of how to create an Amazon Shipping label for an Amazon order."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/labels HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"shipment\": {\n    \"carrier_id\": \"se-123456\",\n    \"service_code\": \"ups_ground\",\n    \"order_source_code\": \"amazon\",\n    \"external_order_id\": \"103-4795772-1364518\",\n    \"items\": [\n      {\n        \"quantity\": 1,\n        \"name\": \"Tea Party Set\",\n        \"external_order_id\" : \"114-2825781-8037847\",\n        \"external_order_item_id\" : \"16902221730370\"\n      },\n      {\n        \"quantity\": 1,\n        \"name\": \"Party Hats\",\n        \"external_order_id\" : \"114-2825781-8037847\",\n        \"external_order_item_id\" : \"16902221730370\"\n      }\n    ],\n    \"ship_date\": \"2019-04-04T05:00:00.000Z\",\n    \"ship_from\": {\n      \"name\": \"John Smith\",\n      \"address_line1\": \"4301 Bull Creek Rd\",\n      \"city_locality\": \"Austin\",\n      \"state_province\": \"TX\",\n      \"postal_code\": \"78731\",\n      \"country_code\": \"US\",\n      \"phone\": \"555-555-55555\"\n    },\n    \"ship_to\": {\n      \"name\": \"Stamps.com\",\n      \"address_line1\": \"1990 E. Grand Ave.\",\n      \"city_locality\": \"El Segundo\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"90245-5013\",\n      \"country_code\": \"US\",\n      \"phone\": \"1-800-608-2677\"\n    },\n    \"packages\": [\n      {\n        \"weight\": {\n          \"value\": 2.5,\n          \"unit\": \"pound\"\n        },\n        \"dimensions\": {\n          \"length\": 24,\n          \"width\": 10,\n          \"height\": 3,\n          \"unit\": \"inch\"\n        }\n      }\n    ]\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll receive a standard label response in return."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"label-reference-fields","__idx":10},"children":["Label Reference Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping does not support adding label messages."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"multi-package-labels","__idx":11},"children":["Multi-Package Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping does not support ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/multi-package"},"children":["multi-package shipments"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"label-branding","__idx":12},"children":["Label Branding"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping does not support ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/branding"},"children":["label branding"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"voiding-labels","__idx":13},"children":["Voiding Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping supports ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/voiding"},"children":["voiding labels"]}," with ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"paperless-labels","__idx":14},"children":["Paperless Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping does not support ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/paperless"},"children":["paperless labels"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-confirmation","__idx":15},"children":["Delivery Confirmation"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Confirmation Type"},"children":["Confirmation Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Code"},"children":["API Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivery"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivery confirmation is requested."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature is required for the shipment to be delivered. This signature may be a neighbor, building manager, or the recipient can authorize the release of the package (without being present)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Adult Signature"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adult_signature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An adult signature is required for the shipment to be delivered."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/delivery-confirmation"},"children":["Delivery Confirmation page"]}," for more details about using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmation"]}," property."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"advanced-options","__idx":16},"children":["Advanced Options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping supports certain ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/carriers/advanced-options"},"children":["advanced options"]},", which you can add to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment"]}," object when creating a shipment or label."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default Value"},"children":["Default Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non_machinable"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates that the package cannot be processed through sorting machines."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To ensure you always have the most up-to-date information about a carrier's advanced options, use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carrier-options"},"children":["list carrier options call"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"manifests","__idx":17},"children":["Manifests"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping does not support ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/manifests"},"children":["manifesting"]}," shipments with ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scheduling-pickups","__idx":18},"children":["Scheduling Pickups"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping does not support ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/pickups"},"children":["scheduling pickups"]}," using ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"service-points-pudo","__idx":19},"children":["Service Points (PUDO)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Buy Shipping does not support shipping to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/pick-up-drop-off/pudo-intro"},"children":["service points"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tracking","__idx":20},"children":["Tracking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipStation API's integration with Amazon Buy Shipping supports receiving tracking updates. Review our ​",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/tracking/tracking"},"children":["Track a Package guides​"]},"​ for details on tracking with the ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"disconnecting-your-amazon-buy-shipping-account","__idx":21},"children":["Disconnecting Your Amazon Buy Shipping Account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the Disconnect section in our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/carriers/delete-carrier"},"children":["Delete a Carrier page"]}," for the process of deleting or disconnecting a carrier from ShipStation API."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you disconnect a carrier account and reconnect it, the account will have a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," in ShipStation API."]}]}]},"headings":[{"value":"Amazon Buy Shipping","id":"amazon-buy-shipping","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Connect Amazon Buy Shipping","id":"connect-amazon-buy-shipping","depth":2},{"value":"Rates","id":"rates","depth":2},{"value":"Example Rate Request","id":"example-rate-request","depth":3},{"value":"Service Details","id":"service-details","depth":2},{"value":"Shipping from Great Britain to Northern Ireland","id":"shipping-from-great-britain-to-northern-ireland","depth":3},{"value":"Return Services","id":"return-services","depth":3},{"value":"Label Support","id":"label-support","depth":2},{"value":"Example Label Request","id":"example-label-request","depth":3},{"value":"Label Reference Fields","id":"label-reference-fields","depth":3},{"value":"Multi-Package Labels","id":"multi-package-labels","depth":3},{"value":"Label Branding","id":"label-branding","depth":3},{"value":"Voiding Labels","id":"voiding-labels","depth":3},{"value":"Paperless Labels","id":"paperless-labels","depth":3},{"value":"Delivery Confirmation","id":"delivery-confirmation","depth":2},{"value":"Advanced Options","id":"advanced-options","depth":2},{"value":"Manifests","id":"manifests","depth":2},{"value":"Scheduling Pickups","id":"scheduling-pickups","depth":2},{"value":"Service Points (PUDO)","id":"service-points-pudo","depth":2},{"value":"Tracking","id":"tracking","depth":2},{"value":"Disconnecting Your Amazon Buy Shipping Account","id":"disconnecting-your-amazon-buy-shipping-account","depth":2}],"frontmatter":{"seo":{"title":"Amazon Buy Shipping"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/carriers/amazon-buy-shipping","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}