{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/carriers/amazon-buy-shipping","default":false,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/docs/carriers/amazon-buy-shipping","default":true,"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 V2 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 V2 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_code"]},": ",{"$$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":["You can connect your Amazon Buy Shipping account via the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.shipstation.com/"},"children":["ShipStation Dashboard"]}," or through the API using the carrier connection endpoints."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.shipstation.com/hc/en-us/articles/7534756493595"},"children":["See our Amazon Buy Shipping API help guide"]}," for steps to connect in the ShipStation 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":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/rates/rates"},"children":["rate shopping"]}," with ShipStation V2 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 /v2/rates/"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/rates HTTP/1.1\nHost: api.shipstation.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":"MarkdownLink","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 V2 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 /v2/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 /v2/labels HTTP/1.1\nHost: api.shipstation.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":"MarkdownLink","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":"MarkdownLink","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":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/labels/voiding"},"children":["voiding labels"]}," with ShipStation V2 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":"MarkdownLink","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":"MarkdownLink","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":"MarkdownLink","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":"MarkdownLink","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":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/manifests"},"children":["manifesting"]}," shipments with ShipStation V2 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":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/shipping/pickups"},"children":["scheduling pickups"]}," using ShipStation V2 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":"MarkdownLink","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 V2 API's integration with Amazon Buy Shipping supports receiving tracking updates. Review our ​",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/shipengine/docs/tracking/tracking"},"children":["Track a Package guides​"]},"​ for details on tracking with the ShipStation V2 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":"MarkdownLink","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 V2 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 V2 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-07-22T16:58:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/docs/carriers/amazon-buy-shipping","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}