{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/models/international-options","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/models/international-options","default":false,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/models/international-options","default":false,"active":true,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"International Options","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":"international-options","__idx":0},"children":["International Options"]},{"$$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":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data Type"},"children":["Data Type"]},{"$$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":["contents"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contents of international shipment. Available options are: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"merchandise\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"documents\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"gift\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"returned_goods\""]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"sample\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customsItems"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Object of strings and numbers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipstation-v1/docs/models/customs-item"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CustomsItem"]}]}," page for specifics. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE"]},": To supply ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customsItems"]}," in the CreateOrder call and have the values not be overwritten by ShipStation, you must set the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["International Settings > Customs Declarations"]}," to \"Leave blank (Enter Manually)\" in the UI: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://ss.shipstation.com/#/settings/international"},"children":["https://ss.shipstation.com/#/settings/international"]}," Please see our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.shipstation.com/hc/en-us/articles/360035991611"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ShipStation's International Settings KB article"]}]}," to learn how to make this change in the UI."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nonDelivery"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Non-Delivery option for international shipment. Available options are: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"return_to_sender\""]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"treat_as_abandoned\""]},". ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE"]},": If the shipment is created through the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipstation-v1/openapi/shipments/create_shipment_label"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Orders"]},"/CreateLabelForOrder"]}," endpoint and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nonDelivery"]}," field is not specified, then the value defaults based on the International Setting in the UI. If the call is being made to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipstation-v1/docs/shipments/create-label"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shipments"]},"/CreateLabel"]}," endpoint and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nonDelivery"]}," field is not specified, then the value will default to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"return_to_sender\""]},"."]}]}]}]}]}]},"headings":[{"value":"International Options","id":"international-options","depth":1}],"frontmatter":{"seo":{"title":"International Options"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipstation-v1/docs/models/international-options","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}