{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/carriers/stamps-usps-guide","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/carriers/stamps-usps-guide","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/carriers/stamps-usps-guide","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"USPS (Stamps.com)","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":"usps-stampscom","__idx":0},"children":["USPS (Stamps.com)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.stamps.com/"},"children":["Stamps.com"]}," with ShipStation API provides access to USPS domestic and international shipping services for packages originating in the United States."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide provides developers with the details needed to build USPS shipping capabilities using a Stamps.com account into your ShipStation API workflows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are using or plan to use the USPS services included with ShipStation API, rather than connecting your own Stamps.com account, see our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/carriers/usps-from-shipengine"},"children":["USPS from ShipStation guide"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$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":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required?"},"children":["Required?"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["username"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["password"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-account","__idx":2},"children":["Connect Account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can connect a Stamps.com account using the POST method to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/connections/carriers/"]}," endpoint, or via the ShipStation API Dashboard."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For instructions on connecting a Stamps.com via the ShipStation API dashboard, go to our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.shipengine.com/hc/en-us/articles/4406871553819"},"children":["Stamps.com help article"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-via-endpoint","__idx":3},"children":["Connect via Endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_name"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stamps_com"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/connections/carriers/:carrier_name"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/connections/carriers/stamps_com HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"username\": \"myusername\",\n  \"password\": \"123456789\",\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful connection will return a response with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]},", which you'll use for any requests for this account going forward."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rates","__idx":4},"children":["Rates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the rates endpoint to fetch estimated rates for services provided by Stamps.com. See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/rates/rates"},"children":["Calculate Shipping Costs page"]}," for details about rate shopping with ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"service-details","__idx":5},"children":["Service Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The tables below provide the services available with Stamps.com, which include both USPS and GlobalPost services. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carrier-services"},"children":["list carrier services"]}," endpoint at any time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"usps-domestic-services","__idx":6},"children":["USPS Domestic Services"]},{"$$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":"Service"},"children":["Service"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Transit Time"},"children":["Transit Time"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Maximum Dimensions (LxWxH)"},"children":["Maximum Dimensions (LxWxH)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Max Weight"},"children":["Max Weight"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Service Code"},"children":["Service Code"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USPS Ground Advantage*"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2-5 days"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["22\" x 18\" x 15\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["70 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_ground_advantage"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USPS Priority Mail"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1-3 days"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["varies by package type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["70 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_priority_mail"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USPS Priority Mail Express"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1-2 days"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L x 2xW x H cannot exceed 108\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["70 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_priority_mail_express"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Media Mail"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2-9 days"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L x 2xW x H cannot exceed 108\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["70 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_media_mail"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT: USPS International Shipping Updates"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"international-mail-service-suspensions---effective-march-3-2026","__idx":7},"children":["International Mail Service Suspensions - Effective: March 3, 2026"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Postal Service™ is ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://about.usps.com/newsroom/service-alerts/international/"},"children":["temporarily suspending acceptance of items destined to the following countries"]},", due to logistics impacts resulting from the conflict in the Middle East."," ","Please refrain from mailing items addressed to the countries listed here until further notice:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Algeria, Armenia, Bahrain, Djibouti, Eritrea, Iran, Iraq, Israel, Kuwait, Libya, Madagascar, Oman, Pakistan, Qatar, Seychelles, Syria, Tanzania, United Arab Emirates"]},"​​"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"hs-codes-required","__idx":8},"children":["HS Codes Required"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["September 1, 2025"]},", the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://about.usps.com/postal-bulletin/2025/pb22682/pb22682.pdf"},"children":["U.S. Postal Service will require"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["all international commercial shipments"]}," to include a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.trade.gov/harmonized-system-hs-codes"},"children":["six-digit Harmonized System (HS) code"]}," on customs declarations ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["for each item"]},", regardless of mail class."," ","The HS code system, created by the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.wcoomd.org/en/topics/nomenclature/overview/what-is-the-harmonized-system.aspx"},"children":["World Customs Organization"]},", is used by customs authorities worldwide to classify goods and assess tariffs. This update aligns USPS mailing standards with new ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Universal Postal Union (UPU) regulations"]},", also taking effect Sept 1, requiring all member countries to enforce six-digit HS codes for commercial goods."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full list of Harmonization Codes, use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://hts.usitc.gov/"},"children":["Harmonized Tariff Schedule search"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"usps-international-services","__idx":9},"children":["USPS International Services"]},{"$$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":"Service"},"children":["Service"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Transit Time"},"children":["Transit Time"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Maximum Dimensions"},"children":["Maximum Dimensions"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Max Weight"},"children":["Max Weight"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Service Code"},"children":["Service Code"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USPS First Class Mail Intl"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["7-21 days"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L x 2xW x H cannot exceed 136\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["64 oz"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_first_class_mail_international"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USPS Priority Mail Intl"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6-10 days"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L x 2xW x H cannot exceed 108\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["70 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_priority_mail_international"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["USPS Priority Mail Express Intl"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3-5 days"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L x 2xW x H cannot exceed 108\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["70 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_priority_mail_express_international"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE:"]}," ","All international shipments using USPS First-Class Mail Int'l, Priority Mail Int'l, or Priority Express Int'l services will use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.shipengine.com/hc/articles/4406871538459#UUID-06961ed6-bd35-7f22-eee2-06e0c5cfd8b8"},"children":["Global Advantage Program"]}," labels by default."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"globalpost-services","__idx":10},"children":["GlobalPost Services"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["GlobalPost international services are also available under the USPS from ShipStation carrier, as USPS is the official first-mile carrier for GlobalPost shipments originating in the US. For all GlobalPost services, transit time will vary depending on the destination country."]},{"$$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":"Service"},"children":["Service"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Max Weight"},"children":["Max Weight"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Service Code"},"children":["Service Code"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GlobalPost Economy Intl"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4.4 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["globalpost_economy"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GlobalPost Standard Intl"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["70 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["globalpost_priority"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GlobalPost Plus"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["66 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gp_plus"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GlobalPost SmartSaver Economy Intl"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4.4 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["globalpost_economy_smart_saver"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GlobalPost SmartSaver Standard Intl"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["70 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["globalpost_priority_smart_saver"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GlobalPost Plus SmartSaver"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["66 lbs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["globalpost_plus"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"return-services","__idx":11},"children":["Return Services"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stamps.com supports returns using any domestic service. Review the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/returns"},"children":["Return Shipping Labels page"]}," for details on creating return labels with ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"packages","__idx":12},"children":["Packages"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/carrier-packaging"},"children":["carrier package types"]}," are available for USPS services:"]},{"$$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":"Package Name"},"children":["Package Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Code"},"children":["API Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Package Details"},"children":["Package Details"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Medium Flat Rate Box"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["medium_flat_rate_box"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domestic and international"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flat Rate Envelope"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flat_rate_envelope"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domestic and international"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Small Flat Rate Box"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["small_flat_rate_box"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domestic and international"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Large Flat Rate Box"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["large_flat_rate_box"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domestic and international"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flat Rate Padded Envelope"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flat_rate_padded_envelope"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domestic and international"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flat Rate Legal Envelope"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flat_rate_legal_envelope"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domestic and international"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"adding-shipment-insurance","__idx":13},"children":["Adding Shipment Insurance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stamps.com supports adding carrier insurance to your shipments."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/insurance"},"children":["Parcel Insurance page"]}," for details on adding shipment insurance with ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"label-support","__idx":14},"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":"label-reference-fields","__idx":15},"children":["Label Reference Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/messages"},"children":["Label messages"]}," are supported for domestic shipments only. You can use all three label reference fields."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"multi-package-labels","__idx":16},"children":["Multi-Package Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["USPS does not support ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/multi-package"},"children":["multi-package shipments"]}," at this time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"label-branding","__idx":17},"children":["Label Branding"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stamps.com supports adding a custom label image to your labels. See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/branding"},"children":["Create Custom Shipping Labels page"]}," for details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"voiding-labels","__idx":18},"children":["Voiding Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stamps.com supports voiding labels using ShipStation API, but it must be done within 28 days of label creation and the label cannot have been scanned by the USPS."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/voiding"},"children":["Void a Label page"]}," for details about voiding labels with ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"paperless-labels","__idx":19},"children":["Paperless Labels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["USPS supports ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/paperless"},"children":["paperless labels"]}," with their services. This means you can generate a QR code for your customer, and they can take that QR code to be scanned at participating USPS locations, who will then print the label for them."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Review our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/paperless"},"children":["paperless labels"]}," page for details on how to generate a QR code instead of a printable label. Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paperless"]}," value for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["display_scheme"]}," property."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example QR Code"]}," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/usps-qr-code.5acd301252ec39453598fddaa2f0e7d75d7f65cceb566a535a041a9a05c93dc7.2b580f94.png","alt":"USPS QR Code"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"customer-communications","__idx":20},"children":["Customer Communications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using paperless labels might be a new experience for your customers. The USPS suggests sending out an email with the QR code label to help educate your customer on what they need to do to ship their package."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The email containing the QR Code should also include instructions on how to find participating USPS Post Offices by visiting https://tools.usps.com/find-location.htm?locationType=po&serviceType=lbroretail&address=18702, where the value of the address parameter is a customer's ZIP Code (such as 18702 in this example). The USPS Retail Associate at that location's Retail Counter will scan the QR Code, print the shipping label, affix it to the package, and provide a receipt."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the customer has access to a printer, they may choose instead to print the label directly at https://tools.usps.com/label-broker.htm?LabelID=XYZZYPJK&zip=18702, where XYZZYPJK is the Label ID returned by ShipStation API, and 18702 is the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ship_from"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postal_code"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"customs-declarations","__idx":21},"children":["Customs Declarations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customs declarations for GlobalPost and GAP labels are submitted to the carrier electronically. See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/international"},"children":["International Shipments page"]}," for details about shipping internationally via ShipStation API."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE: Action Required: New Zealand Border Levy Changes"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Effective April 1, 2026, a new NZD $2.21 (+ GST) levy applies to low-value air freight consignments entering New Zealand. This levy is charged ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["per consignment"]},", not per item."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shipping to New Zealand: Low Value Goods (LVG) Levy"]}," section in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/international"},"children":["International Shipments"]}," for full details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-confirmation","__idx":22},"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":["No confirmation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["none"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Default. When no delivery confirmation is requested."]}]},{"$$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":["For general delivery confirmation."]}]},{"$$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":["A signature is required to complete the delivery."]}]},{"$$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":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Restricted delivery"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["restricted_delivery"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Signature and Adult Signature ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/delivery-confirmation"},"children":["confirmation types"]}," are not supported for international shipments."]},{"$$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":23},"children":["Advanced Options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stamps.com 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":"Name"},"children":["Name"]},{"$$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":["Non Machinable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non_machinable"]}]},{"$$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 USPS sorting machines."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dangerous Goods"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dangerous_goods"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates this shipment contains dangerous goods"]}]}]}]}]},{"$$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":24},"children":["Manifests"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["USPS supports creating manifests (called SCAN forms) via ShipStation API. If you plan to create a USPS SCAN form, you must manifest your day's shipments by 9pm local time."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/manifests"},"children":["Manifests page"]}," for more details about creating manifests with ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scheduling-pickups","__idx":25},"children":["Scheduling Pickups"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["USPS supports scheduling pickups with ShipStation API. Pickups can only be scheduled one day in advance. For example, if you schedule a pickup on the 5th for the 7th, the pickup date scheduled by Stamps.com will be the 6th."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/pickups"},"children":["Schedule a Carrier Pickup page"]}," for more details about scheduling pickups using ShipStation API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"service-points-pudo","__idx":26},"children":["Service Points (PUDO)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["USPS 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":27},"children":["Tracking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipStation API's integration with Stamps.com 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-stampscom-account","__idx":28},"children":["Disconnecting Your Stamps.com 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":"USPS (Stamps.com)","id":"usps-stampscom","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Connect Account","id":"connect-account","depth":2},{"value":"Connect via Endpoint","id":"connect-via-endpoint","depth":3},{"value":"Rates","id":"rates","depth":2},{"value":"Service Details","id":"service-details","depth":2},{"value":"USPS Domestic Services","id":"usps-domestic-services","depth":3},{"value":"International Mail Service Suspensions - Effective: March 3, 2026","id":"international-mail-service-suspensions---effective-march-3-2026","depth":3},{"value":"HS Codes Required","id":"hs-codes-required","depth":3},{"value":"USPS International Services","id":"usps-international-services","depth":3},{"value":"GlobalPost Services","id":"globalpost-services","depth":3},{"value":"Return Services","id":"return-services","depth":3},{"value":"Packages","id":"packages","depth":3},{"value":"Adding Shipment Insurance","id":"adding-shipment-insurance","depth":3},{"value":"Label Support","id":"label-support","depth":2},{"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":"Customer Communications","id":"customer-communications","depth":3},{"value":"Customs Declarations","id":"customs-declarations","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 Stamps.com Account","id":"disconnecting-your-stampscom-account","depth":2}],"frontmatter":{"seo":{"title":"USPS (Stamps.com)"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/carriers/stamps-usps-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}