{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Trackstar","colors":{"primary":"#7691DA","light":"#D3D665","dark":"#2E3B72"},"logo":{"light":"https://mintcdn.com/trackstar/e_R8AMY4ayyVfYRU/logo/light.svg?fit=max\u0026auto=format\u0026n=e_R8AMY4ayyVfYRU\u0026q=85\u0026s=eb832f4ffc768291fd95c4939b2ac6c2","dark":"https://mintcdn.com/trackstar/e_R8AMY4ayyVfYRU/logo/dark.svg?fit=max\u0026auto=format\u0026n=e_R8AMY4ayyVfYRU\u0026q=85\u0026s=1a2845225060cfe1d75c91a7240341a0"},"favicon":"https://mintcdn.com/trackstar/ronaGfFeKtERpohJ/favicon.png?fit=max\u0026auto=format\u0026n=ronaGfFeKtERpohJ\u0026q=85\u0026s=b3a24a0d7d7c7acc8e7394c0640eb8c6","api":{"openapi":"https://production.trackstarhq.com/openapi.json","mdx":{"server":"https://production.trackstarhq.com"}},"navbar":{"primary":{"type":"button","label":"Get an API Key","href":"https://www.trackstarhq.com/#"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/trackstarhq","website":"https://www.trackstarhq.com/"}},"integrations":{"clearbit":{"publicApiKey":"pk_1c5d72a7b03149b504c277cee5b4032a"}},"contextual":{"options":["copy","view","claude","chatgpt","cursor","vscode","mcp","add-mcp","download-spec"],"display":"header"},"markdown":{"instructions":["Trackstar is a unified REST API for WMS, cart, and carrier systems. Base URL: https://production.trackstarhq.com. There is no SDK; call the API with plain HTTP.","Send x-trackstar-api-key on every request. Endpoints scoped to one connection also need x-trackstar-access-token. Read both from environment variables and never print them.","Reads return data Trackstar has already synced from the connected system. Writes (POST, PUT, PATCH, DELETE) are forwarded to the connected system immediately.","A new connection has no data until its initial sync finishes. Wait for the connection.historical-sync-completed webhook, or poll GET /connections/{connection_id} and check historical_sync_completed.","List endpoints page with page_token and next_token (limit is capped at 1000). Repeat every filter on every page. Filters use field[operator]=value, for example created_date[gte]=2026-01-01T00:00:00Z.","Write bodies must not contain null or empty strings; omit the field instead. Call GET /integrations/{integration_type}/{integration_name}/write-info first to learn the exact fields an integration accepts.","To test without real credentials, POST /sandbox/generate-sandbox/{wms|cart|carrier} with the API key returns a sandbox access token. Start at https://docs.trackstarhq.com/how-to-guides/build-with-ai.md and install the skills with: npx skills add https://docs.trackstarhq.com"]},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Request an API Key","icon":"key","href":"https://trackstarhq.com/get-started"},{"anchor":"Login to Dashboard","icon":"browser","href":"https://dashboard.trackstarhq.com"},{"anchor":"WMS Integrations","icon":"warehouse","href":"https://trackstarhq.com/integrations/wms"},{"anchor":"Cart Integrations","icon":"cart-shopping","href":"https://trackstarhq.com/integrations/cart"},{"anchor":"Carrier Integrations","icon":"truck","href":"https://trackstarhq.com/integrations/carrier"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trackstar","hasAudioNarration":false,"actualSubdomain":"trackstar","customDomains":["docs.trackstarhq.com"],"gitSource":{"type":"github","owner":"trackstarhq","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af356a1f9c1e36848f02461","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Guides","count":67},{"language":"default","tag":"How-To Guides","count":58},{"language":"default","tag":"WMS API","count":55},{"language":"default","tag":"WMS API Reference","count":55},{"language":"default","tag":"Webhooks","count":48},{"language":"default","tag":"WMS","count":29},{"language":"default","tag":"Admin API","count":21},{"language":"default","tag":"Admin API Reference","count":20},{"language":"default","tag":"Orders","count":17},{"language":"default","tag":"Cart API","count":16}]},"assistantConfig":{"enableStarterQuestions":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"how-to-guides/webhooks/wms/return-created","slug":"/how-to-guides/webhooks/wms/return-created","pageMetadata":{"openapi":"webhook return.created","title":"Return created","description":"When a Return is created.","href":"/how-to-guides/webhooks/wms/return-created"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"When a Return is created.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"webhook return.created","title":"Return created","description":"When a Return is created.","href":"/how-to-guides/webhooks/wms/return-created"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/trackstar/30b448b1cb413b03/required.js","/_mintlify/custom/trackstar/a23a6fd668fcabff/tab-dropdown.js","/_mintlify/custom/trackstar/bf284930523528a1/write-fields.js"],"openApiReferenceData":{"operation":{"operationId":"webhook_return.created","summary":"Return created","description":"When a Return is created.","security":[],"requestBody":"8d96e16b-c737-44d3-9ba6-ea2ac2fa26bf","responses":{"200":"adf7b090-c5c8-4dcf-92d4-17c9d901f68e"},"method":"post","type":"webhook","servers":["3272eb7c-71a4-413d-911c-fcab469597e6"],"path":"return.created","baseUrlOptions":["https://production.trackstarhq.com"],"title":"Return created","codeSamples":[],"requiredOnlyExamples":false,"requestExamples":[{"language":"json","filename":"Example","code":"{\n \"connection_id\": \"connection_id\",\n \"data\": {\n \"id\": \"return_id\",\n \"warehouse_customer_id\": \"warehouse_customer_id\",\n \"created_date\": \"2022-01-01T00:00:00Z\",\n \"updated_date\": \"2022-01-02T05:05:05Z\",\n \"status\": \"open\",\n \"raw_status\": \"raw_status\",\n \"order_id\": \"order_id\",\n \"notes\": [\n \"This is a note\"\n ],\n \"line_items\": [\n {\n \"inventory_item_id\": \"item_id\",\n \"sku\": \"sku\",\n \"expected_quantity\": 1,\n \"received_quantity\": 1,\n \"restocked_quantity\": 1,\n \"return_reason\": \"Too Small\"\n }\n ],\n \"shipments\": [\n {\n \"tracking_number\": \"tracking_number\",\n \"shipped_date\": \"2023-02-03T02:04:06Z\",\n \"arrived_date\": \"2023-02-03T02:04:06Z\",\n \"warehouse_id\": \"warehouse_id\",\n \"carrier_id\": \"carrier_id\",\n \"carrier_name\": \"carrier_name\",\n \"scac\": \"FDXG\",\n \"shipping_cost\": 1.23,\n \"measurements\": {\n \"length\": 1,\n \"width\": 1,\n \"height\": 1,\n \"unit\": \"in\",\n \"weight\": 1,\n \"weight_unit\": \"lb\"\n },\n \"line_items\": [\n {\n \"inventory_item_id\": \"item_id\",\n \"sku\": \"sku\",\n \"quantity\": 4,\n \"receiving_details\": [\n {\n \"quantity\": 1,\n \"condition\": \"good\",\n \"disposition\": \"restocked\"\n },\n {\n \"quantity\": 1,\n \"condition\": \"damaged\",\n \"disposition\": \"scrapped\"\n }\n ]\n }\n ]\n }\n ],\n \"external_system_url\": \"https://example.com/return/123\",\n \"trackstar_tags\": [\n \"tag1\",\n \"tag2\",\n {\n \"tag3\": \"value3\"\n }\n ],\n \"additional_fields\": {\n \"key\": \"value\"\n },\n \"trackstar_created_date\": \"2023-03-15T13:45:30Z\",\n \"trackstar_updated_date\": \"2023-03-15T13:45:30Z\"\n },\n \"event_type\": \"return.created\",\n \"integration_name\": \"integration_name\",\n \"integration_type\": \"wms\"\n}"}],"requestExampleType":"webhook","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["connection_id","data","event_type","integration_name","integration_type"],"properties":{"connection_id":{"type":"string","description":"","example":"connection_id","isRequired":true,"uniqueKey":"oneOf.0.connection_id","typeLabel":"string"},"data":{"type":"object","properties":{"id":{"type":"string","description":"The unique ID of the return.","example":"return_id","isRequired":true,"uniqueKey":"oneOf.0.data.id","typeLabel":"string"},"warehouse_customer_id":{"oneOf":[{"type":"string","description":"The ID of the merchant/tenant/customer that owns the return. Can be passed into the [Warehouse Customer](/api-reference/wms-api/warehouse-customers/get-item) endpoint for more details.","example":"warehouse_customer_id","isRequired":true,"uniqueKey":"oneOf.0.data.warehouse_customer_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the merchant/tenant/customer that owns the return. Can be passed into the [Warehouse Customer](/api-reference/wms-api/warehouse-customers/get-item) endpoint for more details.","example":"warehouse_customer_id","isRequired":true,"uniqueKey":"oneOf.0.data.warehouse_customer_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.warehouse_customer_id","typeLabel":"string | null"},"created_date":{"type":"string","format":"date-time","description":"The date the return was created.","example":"2022-01-01T00:00:00Z","isRequired":true,"uniqueKey":"oneOf.0.data.created_date","typeLabel":"string\u003cdate-time>"},"updated_date":{"type":"string","format":"date-time","description":"The date the return was last updated.","example":"2022-01-02T05:05:05Z","isRequired":true,"uniqueKey":"oneOf.0.data.updated_date","typeLabel":"string\u003cdate-time>"},"status":{"type":"string","enum":["open","in-transit","receiving","received","cancelled","other"],"description":"The status of the return. See the [return information](info) for more details.","example":"open","isRequired":true,"uniqueKey":"oneOf.0.data.status","typeLabel":"enum\u003cstring>"},"raw_status":{"oneOf":[{"type":"string","description":"The raw status (if available) returned directly from the WMS.","example":"raw_status","isRequired":true,"uniqueKey":"oneOf.0.data.raw_status.oneOf.0","typeLabel":"string"},{"type":"null","description":"The raw status (if available) returned directly from the WMS.","example":"raw_status","isRequired":true,"uniqueKey":"oneOf.0.data.raw_status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.raw_status","typeLabel":"string | null"},"order_id":{"oneOf":[{"type":"string","description":"The ID of the order that the return is associated with. Can be passed into the [Order](/api-reference/wms-api/orders/get-item) endpoint for more details.","example":"order_id","isRequired":true,"uniqueKey":"oneOf.0.data.order_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the order that the return is associated with. Can be passed into the [Order](/api-reference/wms-api/orders/get-item) endpoint for more details.","example":"order_id","isRequired":true,"uniqueKey":"oneOf.0.data.order_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.order_id","typeLabel":"string | null"},"notes":{"type":"array","description":"A list of notes associated with the return.","example":["This is a note"],"items":{"type":"string","description":"This is a note","example":"notes","uniqueKey":"oneOf.0.data.notes.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"oneOf.0.data.notes","typeLabel":"string[]"},"line_items":{"type":"array","description":"A list of inventory items included in the return.","example":[{"inventory_item_id":"item_id","sku":"sku","expected_quantity":1,"received_quantity":1,"restocked_quantity":1,"return_reason":"Too Small"}],"items":{"type":"object","properties":{"inventory_item_id":{"type":"string","description":"Can be passed into the [Inventory](/api-reference/wms-api/inventory/get-item) endpoint for more details.","example":"item_id","isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].inventory_item_id","typeLabel":"string"},"sku":{"oneOf":[{"type":"string","description":"","example":"sku","isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].sku.oneOf.0","typeLabel":"string"},{"type":"null","description":"","example":"sku","isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].sku.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].sku","typeLabel":"string | null"},"expected_quantity":{"type":"integer","description":"How many units are expected to arrive.","example":1,"isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].expected_quantity","typeLabel":"integer"},"received_quantity":{"type":"integer","description":"How many units actually arrived.","example":1,"isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].received_quantity","typeLabel":"integer"},"restocked_quantity":{"oneOf":[{"type":"integer","description":"The number of returned inventory items that have been restocked.","example":1,"isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].restocked_quantity.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The number of returned inventory items that have been restocked.","example":1,"isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].restocked_quantity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].restocked_quantity","typeLabel":"integer | null"},"return_reason":{"oneOf":[{"type":"string","description":"The reason for the return.","example":"Too Small","isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].return_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"The reason for the return.","example":"Too Small","isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].return_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.line_items.items.[INDEX].return_reason","typeLabel":"string | null"}},"required":["expected_quantity","inventory_item_id","received_quantity","restocked_quantity","return_reason","sku"],"additionalProperties":false,"title":"WmsReturnLineItem","uniqueKey":"oneOf.0.data.line_items.items.[INDEX]","typeLabel":"WmsReturnLineItem · object"},"isRequired":true,"uniqueKey":"oneOf.0.data.line_items","typeLabel":"WmsReturnLineItem · object[]"},"shipments":{"type":"array","description":"List of the shipments associated with the return.","example":[{"tracking_number":"tracking_number","shipped_date":"2023-02-03T02:04:06Z","arrived_date":"2023-02-03T02:04:06Z","warehouse_id":"warehouse_id","carrier_id":"carrier_id","carrier_name":"carrier_name","scac":"FDXG","shipping_cost":1.23,"measurements":{"length":1,"width":1,"height":1,"unit":"in","weight":1,"weight_unit":"lb"},"line_items":[{"inventory_item_id":"item_id","sku":"sku","quantity":4,"receiving_details":[{"quantity":1,"condition":"good","disposition":"restocked"},{"quantity":1,"condition":"damaged","disposition":"scrapped"}]}]}],"items":{"type":"object","properties":{"tracking_number":{"oneOf":[{"type":"string","description":"The tracking number of the shipment.","example":"tracking_number","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].tracking_number.oneOf.0","typeLabel":"string"},{"type":"null","description":"The tracking number of the shipment.","example":"tracking_number","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].tracking_number.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].tracking_number","typeLabel":"string | null"},"shipped_date":{"oneOf":[{"type":"string","format":"date-time","description":"The date the shipment was sent.","example":"2023-03-15T13:45:30Z","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].shipped_date.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"The date the shipment was sent.","example":"2023-03-15T13:45:30Z","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].shipped_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].shipped_date","typeLabel":"string\u003cdate-time> | null"},"arrived_date":{"oneOf":[{"type":"string","format":"date-time","description":"The date the shipment arrived.","example":"2023-03-15T13:45:30Z","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].arrived_date.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"The date the shipment arrived.","example":"2023-03-15T13:45:30Z","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].arrived_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].arrived_date","typeLabel":"string\u003cdate-time> | null"},"warehouse_id":{"oneOf":[{"type":"string","description":"The ID of the warehouse the shipment was sent to. Can be passed into the [Warehouse](/api-reference/wms-api/warehouses/get-item) endpoint for more details.","example":"warehouse_id","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].warehouse_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the warehouse the shipment was sent to. Can be passed into the [Warehouse](/api-reference/wms-api/warehouses/get-item) endpoint for more details.","example":"warehouse_id","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].warehouse_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].warehouse_id","typeLabel":"string | null"},"carrier_id":{"oneOf":[{"type":"string","description":"The ID of the carrier for the shipment.","example":"carrier_id","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].carrier_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the carrier for the shipment.","example":"carrier_id","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].carrier_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].carrier_id","typeLabel":"string | null"},"carrier_name":{"oneOf":[{"type":"string","description":"The name of the carrier for the shipment.","example":"carrier_name","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].carrier_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the carrier for the shipment.","example":"carrier_name","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].carrier_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].carrier_name","typeLabel":"string | null"},"scac":{"oneOf":[{"type":"string","description":"The Standard Carrier Alpha Code (SCAC) for the shipment.","example":"FDXG","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].scac.oneOf.0","typeLabel":"string"},{"type":"null","description":"The Standard Carrier Alpha Code (SCAC) for the shipment.","example":"FDXG","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].scac.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].scac","typeLabel":"string | null"},"shipping_cost":{"oneOf":[{"type":"number","description":"The cost of the shipment.","example":0,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].shipping_cost.oneOf.0","typeLabel":"number"},{"type":"null","description":"The cost of the shipment.","example":0,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].shipping_cost.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].shipping_cost","typeLabel":"number | null"},"measurements":{"type":"object","properties":{"length":{"oneOf":[{"type":"number","description":"","example":1.5,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.length.oneOf.0","typeLabel":"number"},{"type":"null","description":"","example":1.5,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.length.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.length","typeLabel":"number | null"},"width":{"oneOf":[{"type":"number","description":"","example":1.5,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.width.oneOf.0","typeLabel":"number"},{"type":"null","description":"","example":1.5,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.width.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.width","typeLabel":"number | null"},"height":{"oneOf":[{"type":"number","description":"","example":1.5,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.height.oneOf.0","typeLabel":"number"},{"type":"null","description":"","example":1.5,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.height.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.height","typeLabel":"number | null"},"unit":{"oneOf":[{"type":"string","enum":["cm","in"],"description":"The unit of measurement for the size of the shipment.","example":"in","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.unit.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["cm","in"],"description":"The unit of measurement for the size of the shipment.","example":"in","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.unit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.unit","typeLabel":"enum\u003cstring> | null"},"weight":{"oneOf":[{"type":"number","description":"","example":2.5,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.weight.oneOf.0","typeLabel":"number"},{"type":"null","description":"","example":2.5,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.weight.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.weight","typeLabel":"number | null"},"weight_unit":{"oneOf":[{"type":"string","enum":["kg","oz","lb"],"description":"The unit of measurement for the weight of the shipment.","example":"lb","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.weight_unit.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["kg","oz","lb"],"description":"The unit of measurement for the weight of the shipment.","example":"lb","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.weight_unit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements.weight_unit","typeLabel":"enum\u003cstring> | null"}},"required":["height","length","unit","weight","weight_unit","width"],"additionalProperties":false,"title":"ShipmentMeasurements","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].measurements","typeLabel":"ShipmentMeasurements · object"},"line_items":{"type":"array","description":"List of inventory items items in the shipment.","items":{"type":"object","properties":{"inventory_item_id":{"type":"string","description":"Can be passed into the [Inventory](/api-reference/wms-api/inventory/get-item) endpoint for more details.","example":"item_id","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].inventory_item_id","typeLabel":"string"},"sku":{"oneOf":[{"type":"string","description":"","example":"sku","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].sku.oneOf.0","typeLabel":"string"},{"type":"null","description":"","example":"sku","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].sku.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].sku","typeLabel":"string | null"},"quantity":{"type":"integer","description":"How many units were shipped.","example":1,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].quantity","typeLabel":"integer"},"receiving_details":{"type":"array","description":"Details about received items in the shipment.","example":[{"quantity":1,"condition":"good","disposition":"restocked"}],"items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"description":"How many units were received in this condition and disposition.","example":1,"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].receiving_details.items.[INDEX].quantity","typeLabel":"integer"},"condition":{"oneOf":[{"type":"string","description":"The condition of the item received.","example":"good","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].receiving_details.items.[INDEX].condition.oneOf.0","typeLabel":"string"},{"type":"null","description":"The condition of the item received.","example":"good","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].receiving_details.items.[INDEX].condition.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].receiving_details.items.[INDEX].condition","typeLabel":"string | null"},"disposition":{"oneOf":[{"type":"string","description":"The disposition of the item received, eg restocked or discarded.","example":"restocked","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].receiving_details.items.[INDEX].disposition.oneOf.0","typeLabel":"string"},{"type":"null","description":"The disposition of the item received, eg restocked or discarded.","example":"restocked","isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].receiving_details.items.[INDEX].disposition.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].receiving_details.items.[INDEX].disposition","typeLabel":"string | null"}},"required":["condition","disposition","quantity"],"additionalProperties":false,"title":"ReceivingDetails","uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].receiving_details.items.[INDEX]","typeLabel":"ReceivingDetails · object"},"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX].receiving_details","typeLabel":"ReceivingDetails · object[]"}},"required":["inventory_item_id","quantity","receiving_details","sku"],"additionalProperties":false,"title":"ReturnShipmentLineItem","uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items.items.[INDEX]","typeLabel":"ReturnShipmentLineItem · object"},"isRequired":true,"uniqueKey":"oneOf.0.data.shipments.items.[INDEX].line_items","typeLabel":"ReturnShipmentLineItem · object[]"}},"required":["arrived_date","carrier_id","carrier_name","line_items","measurements","scac","shipped_date","shipping_cost","tracking_number","warehouse_id"],"additionalProperties":false,"title":"ReturnShipment","uniqueKey":"oneOf.0.data.shipments.items.[INDEX]","typeLabel":"ReturnShipment · object"},"isRequired":true,"uniqueKey":"oneOf.0.data.shipments","typeLabel":"ReturnShipment · object[]"},"external_system_url":{"oneOf":[{"type":"string","description":"URL link to the return in the external system (WMS/Freight etc).","example":"https://example.com/return/123","isRequired":true,"uniqueKey":"oneOf.0.data.external_system_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL link to the return in the external system (WMS/Freight etc).","example":"https://example.com/return/123","isRequired":true,"uniqueKey":"oneOf.0.data.external_system_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.external_system_url","typeLabel":"string | null"},"trackstar_tags":{"oneOf":[{"type":"array","description":"A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.","example":["tag1","tag2",{"tag3":"value3"}],"items":{"oneOf":[{}],"uniqueKey":"oneOf.0.data.trackstar_tags.oneOf.0.items.[INDEX]","typeLabel":"any"},"isRequired":true,"uniqueKey":"oneOf.0.data.trackstar_tags.oneOf.0","typeLabel":"any[]"},{"type":"null","description":"A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.","example":["tag1","tag2",{"tag3":"value3"}],"items":{"oneOf":[{}]},"isRequired":true,"uniqueKey":"oneOf.0.data.trackstar_tags.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.data.trackstar_tags","typeLabel":"any[] | null"},"additional_fields":{"type":"object","description":"Integration-specific fields","example":{"key":"value"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.0.data.additional_fields.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"oneOf.0.data.additional_fields","typeLabel":"object"},"trackstar_created_date":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","isRequired":true,"uniqueKey":"oneOf.0.data.trackstar_created_date","typeLabel":"string\u003cdate-time>"},"trackstar_updated_date":{"type":"string","format":"date-time","description":"","example":"2023-03-15T13:45:30Z","isRequired":true,"uniqueKey":"oneOf.0.data.trackstar_updated_date","typeLabel":"string\u003cdate-time>"}},"required":["additional_fields","created_date","external_system_url","id","line_items","notes","order_id","raw_status","shipments","status","trackstar_created_date","trackstar_tags","trackstar_updated_date","updated_date","warehouse_customer_id"],"additionalProperties":false,"title":"WmsReturnApiItemSchema","isRequired":true,"uniqueKey":"oneOf.0.data","typeLabel":"WmsReturnApiItemSchema · object"},"event_type":{"type":"string","enum":["return.created"],"description":"","example":"return.created","isRequired":true,"uniqueKey":"oneOf.0.event_type","typeLabel":"enum\u003cstring>"},"integration_name":{"type":"string","description":"","example":"integration_name","isRequired":true,"uniqueKey":"oneOf.0.integration_name","typeLabel":"string"},"integration_type":{"type":"string","description":"","example":"wms","isRequired":true,"uniqueKey":"oneOf.0.integration_type","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["connection_id","data","data_truncated","data_url","event_type","integration_name","integration_type"],"properties":{"connection_id":{"type":"string","description":"","example":"connection_id","isRequired":true,"uniqueKey":"oneOf.1.connection_id","typeLabel":"string"},"data":{"type":"object","properties":{"id":{"type":"string","description":"The record this event is about. Absent on connection webhooks, which carry dates rather than a row.","example":"id","uniqueKey":"oneOf.1.data.id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.data","typeLabel":"object"},"event_type":{"type":"string","enum":["return.created"],"description":"","example":"return.created","isRequired":true,"uniqueKey":"oneOf.1.event_type","typeLabel":"enum\u003cstring>"},"integration_name":{"type":"string","description":"","example":"integration_name","isRequired":true,"uniqueKey":"oneOf.1.integration_name","typeLabel":"string"},"integration_type":{"type":"string","description":"","example":"wms","isRequired":true,"uniqueKey":"oneOf.1.integration_type","typeLabel":"string"},"data_truncated":{"type":"boolean","description":"Always true on this shape. The event was too large to send in full, so `data` holds only the `id` and `previous_attributes` is empty.","example":true,"isRequired":true,"uniqueKey":"oneOf.1.data_truncated","typeLabel":"boolean"},"data_url":{"type":"string","description":"Called with your usual API key, it returns a download link for this event exactly as it would have been delivered.","example":"https://production.trackstarhq.com/webhooks/payloads/payload_id","isRequired":true,"uniqueKey":"oneOf.1.data_url","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"connection_id":"connection_id","data":{"id":"return_id","warehouse_customer_id":"warehouse_customer_id","created_date":"2022-01-01T00:00:00Z","updated_date":"2022-01-02T05:05:05Z","status":"open","raw_status":"raw_status","order_id":"order_id","notes":["This is a note"],"line_items":[{"inventory_item_id":"item_id","sku":"sku","expected_quantity":1,"received_quantity":1,"restocked_quantity":1,"return_reason":"Too Small"}],"shipments":[{"tracking_number":"tracking_number","shipped_date":"2023-02-03T02:04:06Z","arrived_date":"2023-02-03T02:04:06Z","warehouse_id":"warehouse_id","carrier_id":"carrier_id","carrier_name":"carrier_name","scac":"FDXG","shipping_cost":1.23,"measurements":{"length":1,"width":1,"height":1,"unit":"in","weight":1,"weight_unit":"lb"},"line_items":[{"inventory_item_id":"item_id","sku":"sku","quantity":4,"receiving_details":[{"quantity":1,"condition":"good","disposition":"restocked"},{"quantity":1,"condition":"damaged","disposition":"scrapped"}]}]}],"external_system_url":"https://example.com/return/123","trackstar_tags":["tag1","tag2",{"tag3":"value3"}],"additional_fields":{"key":"value"},"trackstar_created_date":"2023-03-15T13:45:30Z","trackstar_updated_date":"2023-03-15T13:45:30Z"},"event_type":"return.created","integration_name":"integration_name","integration_type":"wms"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"adf7b090-c5c8-4dcf-92d4-17c9d901f68e":{"description":"Success","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{},"servers":{"3272eb7c-71a4-413d-911c-fcab469597e6":{"description":"Trackstar API","url":"https://production.trackstarhq.com"}}},"originalFileLocation":"https://production.trackstarhq.com/openapi.json"},"subdomain":"trackstar","siteName":"Trackstar","title":"Return created - Trackstar","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-27T19:03:32.893Z","originalFileLocation":"how-to-guides/webhooks/wms/return-created.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"When a Return is created.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trackstar\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Return created - Trackstar\">\u003cmeta data-mint-head property=\"og:description\" content=\"When a Return is created.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trackstar\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trackstar.mintlify.site/_mintlify/api/og/v2?division=WMS\u0026amp;title=Return+created\u0026amp;description=When+a+Return+is+created.\u0026amp;theme=e80604f17ac1c49831a5e6d2\u0026amp;signature=94a37955fca0883285964a14db77943cb9998643a90eed471c20d65c778a3f27\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Return created - Trackstar\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"When a Return is created.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trackstar.mintlify.site/_mintlify/api/og/v2?division=WMS\u0026amp;title=Return+created\u0026amp;description=When+a+Return+is+created.\u0026amp;theme=e80604f17ac1c49831a5e6d2\u0026amp;signature=94a37955fca0883285964a14db77943cb9998643a90eed471c20d65c778a3f27\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/trackstar/pv8TH9ZNYgztdvmO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trackstar\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7691DA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/how-to-guides/webhooks/wms/return-created.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trackstarhq.com/#organization\",\"name\":\"Trackstar\",\"url\":\"https://docs.trackstarhq.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/trackstar/e_R8AMY4ayyVfYRU/logo/light.svg?fit=max\u0026auto=format\u0026n=e_R8AMY4ayyVfYRU\u0026q=85\u0026s=eb832f4ffc768291fd95c4939b2ac6c2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trackstarhq.com#website\",\"name\":\"Trackstar\",\"url\":\"https://docs.trackstarhq.com\",\"publisher\":{\"@id\":\"https://docs.trackstarhq.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created#webpage\",\"url\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created\",\"name\":\"Return created\",\"description\":\"When a Return is created.\",\"dateModified\":\"2026-05-27T19:03:32.893Z\",\"isPartOf\":{\"@id\":\"https://docs.trackstarhq.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"How-To Guides\",\"item\":\"https://docs.trackstarhq.com/how-to-guides/getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhooks\",\"item\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/webhooks\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"WMS\",\"item\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/bill-created\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Return created\",\"item\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created#apireference\",\"headline\":\"Return created\",\"name\":\"Return created\",\"description\":\"When a Return is created.\",\"url\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trackstarhq.com/how-to-guides/webhooks/wms/return-created#webpage\"},\"dateModified\":\"2026-05-27T19:03:32.893Z\",\"publisher\":{\"@id\":\"https://docs.trackstarhq.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trackstarhq.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trackstar\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Trackstar","nav":{"global":{"anchors":[{"anchor":"Request an API Key","icon":"key","href":"https://trackstarhq.com/get-started"},{"anchor":"Login to Dashboard","icon":"browser","href":"https://dashboard.trackstarhq.com"},{"anchor":"WMS Integrations","icon":"warehouse","href":"https://trackstarhq.com/integrations/wms"},{"anchor":"Cart Integrations","icon":"cart-shopping","href":"https://trackstarhq.com/integrations/cart"},{"anchor":"Carrier Integrations","icon":"truck","href":"https://trackstarhq.com/integrations/carrier"}]},"tabs":[{"tab":"Guides","groups":[{"group":"Home","pages":[{"title":"Welcome to Trackstar!","href":"/introduction"}]},{"group":"How-To Guides","pages":[{"title":"Getting Started","href":"/how-to-guides/getting-started"},{"title":"About the API","href":"/how-to-guides/about-the-api"},{"title":"Build with AI Agents","href":"/how-to-guides/build-with-ai"},{"title":"Trackstar Link","href":"/how-to-guides/trackstar-link"},{"title":"Syncing Data","href":"/how-to-guides/syncing-data"},{"title":"Connection Issues","href":"/how-to-guides/connection-issues"},{"title":"Sandbox","href":"/how-to-guides/sandbox"},{"group":"Webhooks","pages":[{"title":"Webhooks","href":"/how-to-guides/webhooks/webhooks"},{"group":"Admin","pages":[{"openapi":"webhook install.failed","title":"Install failed","href":"/how-to-guides/webhooks/admin/install-failed"},{"openapi":"webhook connection.created","title":"Connection created","href":"/how-to-guides/webhooks/admin/connection-created"},{"openapi":"webhook connection.historical-sync-completed","title":"Connection historical sync completed","href":"/how-to-guides/webhooks/admin/connection-historical-sync"},{"openapi":"webhook connection.force-sync-completed","title":"Connection force sync completed","href":"/how-to-guides/webhooks/admin/connection-force-sync-completed"},{"openapi":"webhook connection.sync-job-completed","title":"Connection sync job completed","href":"/how-to-guides/webhooks/admin/connection-sync-job-completed"},{"openapi":"webhook connection.sync-job-stuck","title":"Connection sync job stuck","href":"/how-to-guides/webhooks/admin/connection-sync-job-stuck"},{"openapi":"webhook connection.schedule-stuck","title":"Connection schedule stuck","href":"/how-to-guides/webhooks/admin/connection-schedule-stuck"},{"openapi":"webhook connection.deleted","title":"Connection deleted","href":"/how-to-guides/webhooks/admin/connection-deleted"},{"openapi":"webhook connection-error.created","title":"Connection error created","href":"/how-to-guides/webhooks/admin/connection-error-created"},{"openapi":"webhook connection-error.updated","title":"Connection error updated","href":"/how-to-guides/webhooks/admin/connection-error-updated"},{"openapi":"webhook connection-error.deleted","title":"Connection error deleted","href":"/how-to-guides/webhooks/admin/connection-error-deleted"}]},{"group":"WMS","pages":[{"openapi":"webhook bill.created","title":"Bill created","href":"/how-to-guides/webhooks/wms/bill-created"},{"openapi":"webhook bill.updated","title":"Bill updated","href":"/how-to-guides/webhooks/wms/bill-updated"},{"openapi":"webhook inbound-shipment.created","title":"Inbound shipment created","href":"/how-to-guides/webhooks/wms/inbound-shipment-created"},{"openapi":"webhook inbound-shipment.receipt.created","title":"Inbound shipment receipt created","href":"/how-to-guides/webhooks/wms/inbound-shipment-receipt-created"},{"openapi":"webhook inbound-shipment.updated","title":"Inbound shipment updated","href":"/how-to-guides/webhooks/wms/inbound-shipment-updated"},{"openapi":"webhook inventory.created","title":"Inventory created","href":"/how-to-guides/webhooks/wms/inventory-created"},{"openapi":"webhook inventory.updated","title":"Inventory updated","href":"/how-to-guides/webhooks/wms/inventory-updated"},{"openapi":"webhook inventory_ledger.created","title":"Inventory_ledger created","href":"/how-to-guides/webhooks/wms/inventory-ledger-created"},{"openapi":"webhook inventory_ledger.updated","title":"Inventory_ledger updated","href":"/how-to-guides/webhooks/wms/inventory-ledger-updated"},{"openapi":"webhook order.created","title":"Order created","href":"/how-to-guides/webhooks/wms/order-created"},{"openapi":"webhook order.shipment.created","title":"Order shipment created","href":"/how-to-guides/webhooks/wms/order-shipment-created"},{"openapi":"webhook order.updated","title":"Order updated","href":"/how-to-guides/webhooks/wms/order-updated"},{"openapi":"webhook product.created","title":"Product created","href":"/how-to-guides/webhooks/wms/product-created"},{"openapi":"webhook product.updated","title":"Product updated","description":"When a Kit is updated.","href":"/how-to-guides/webhooks/wms/product-updated"},{"openapi":"webhook return.created","title":"Return created","href":"/how-to-guides/webhooks/wms/return-created"},{"openapi":"webhook return.updated","title":"Return updated","description":"When a Return is updated.","href":"/how-to-guides/webhooks/wms/return-updated"},{"openapi":"webhook shipping-method.created","title":"Shipping method created","href":"/how-to-guides/webhooks/wms/shipping-method-created"},{"openapi":"webhook shipping-method.updated","title":"Shipping method updated","href":"/how-to-guides/webhooks/wms/shipping-method-updated"},{"openapi":"webhook warehouse-customer.created","title":"Warehouse customer created","href":"/how-to-guides/webhooks/wms/warehouse-customer-created"},{"openapi":"webhook warehouse-customer.updated","title":"Warehouse customer updated","href":"/how-to-guides/webhooks/wms/warehouse-customer-updated"},{"openapi":"webhook warehouse-location.created","title":"Warehouse location created","href":"/how-to-guides/webhooks/wms/warehouse-location-created"},{"openapi":"webhook warehouse-location.updated","title":"Warehouse location updated","href":"/how-to-guides/webhooks/wms/warehouse-location-updated"},{"openapi":"webhook warehouse.created","title":"Warehouse created","href":"/how-to-guides/webhooks/wms/warehouse-created"},{"openapi":"webhook warehouse.updated","title":"Warehouse updated","href":"/how-to-guides/webhooks/wms/warehouse-updated"}]},{"group":"Cart","pages":[{"openapi":"webhook cart-order.created","title":"Cart order created","href":"/how-to-guides/webhooks/cart/cart-order-created"},{"openapi":"webhook cart-order.cart-shipment.created","title":"Cart order cart shipment created","href":"/how-to-guides/webhooks/cart/cart-order-shipment-created"},{"openapi":"webhook cart-order.updated","title":"Cart order updated","href":"/how-to-guides/webhooks/cart/cart-order-updated"},{"openapi":"webhook cart-product.created","title":"Cart product created","href":"/how-to-guides/webhooks/cart/cart-product-created"},{"openapi":"webhook cart-product.updated","title":"Cart product updated","href":"/how-to-guides/webhooks/cart/cart-product-updated"},{"openapi":"webhook cart-warehouse.created","title":"Cart warehouse created","href":"/how-to-guides/webhooks/cart/cart-warehouse-created"},{"openapi":"webhook cart-warehouse.updated","title":"Cart warehouse updated","href":"/how-to-guides/webhooks/cart/cart-warehouse-updated"}]},{"group":"Freight","pages":[{"openapi":"webhook freight-shipment.created","title":"Freight shipment created","href":"/how-to-guides/webhooks/freight/freight-shipment-created"},{"openapi":"webhook freight-shipment.updated","title":"Freight shipment updated","href":"/how-to-guides/webhooks/freight/freight-shipment-updated"}]},{"group":"Carrier","pages":[{"openapi":"webhook carrier-file.created","title":"Carrier file created","href":"/how-to-guides/webhooks/carrier/carrier-file-created"},{"openapi":"webhook carrier-invoice-line-item.created","title":"Carrier invoice line item created","href":"/how-to-guides/webhooks/carrier/carrier-invoice-line-item-created"},{"openapi":"webhook carrier-invoice-line-item.updated","title":"Carrier invoice line item updated","href":"/how-to-guides/webhooks/carrier/carrier-invoice-line-item-updated"}]},{"group":"ERP","hidden":true,"pages":[{"openapi":"webhook erp-sales-order.created","title":"Erp sales order created","href":"/how-to-guides/webhooks/erp/erp-sales-order-created"},{"openapi":"webhook erp-sales-order.updated","title":"Erp sales order updated","href":"/how-to-guides/webhooks/erp/erp-sales-order-updated"},{"openapi":"webhook erp-sales-order-shipment.created","title":"Erp sales order shipment created","href":"/how-to-guides/webhooks/erp/erp-sales-order-shipment-created"},{"openapi":"webhook erp-sales-order-shipment.updated","title":"Erp sales order shipment updated","href":"/how-to-guides/webhooks/erp/erp-sales-order-shipment-updated"},{"openapi":"webhook erp-purchase-order.created","title":"Erp purchase order created","href":"/how-to-guides/webhooks/erp/erp-purchase-order-created"},{"openapi":"webhook erp-purchase-order.updated","title":"Erp purchase order updated","href":"/how-to-guides/webhooks/erp/erp-purchase-order-updated"},{"openapi":"webhook erp-purchase-order-receipt.created","title":"Erp purchase order receipt created","href":"/how-to-guides/webhooks/erp/erp-purchase-order-receipt-created"},{"openapi":"webhook erp-purchase-order-receipt.updated","title":"Erp purchase order receipt updated","href":"/how-to-guides/webhooks/erp/erp-purchase-order-receipt-updated"},{"openapi":"webhook erp-inventory.created","title":"Erp inventory created","href":"/how-to-guides/webhooks/erp/erp-inventory-created"},{"openapi":"webhook erp-inventory.updated","title":"Erp inventory updated","href":"/how-to-guides/webhooks/erp/erp-inventory-updated"},{"openapi":"webhook erp-item.created","title":"Erp item created","href":"/how-to-guides/webhooks/erp/erp-item-created"},{"openapi":"webhook erp-item.updated","title":"Erp item updated","href":"/how-to-guides/webhooks/erp/erp-item-updated"},{"openapi":"webhook erp-location.created","title":"Erp location created","href":"/how-to-guides/webhooks/erp/erp-location-created"},{"openapi":"webhook erp-location.updated","title":"Erp location updated","href":"/how-to-guides/webhooks/erp/erp-location-updated"},{"openapi":"webhook erp-customer.created","title":"Erp customer created","href":"/how-to-guides/webhooks/erp/erp-customer-created"},{"openapi":"webhook erp-customer.updated","title":"Erp customer updated","href":"/how-to-guides/webhooks/erp/erp-customer-updated"},{"openapi":"webhook erp-vendor.created","title":"Erp vendor created","href":"/how-to-guides/webhooks/erp/erp-vendor-created"},{"openapi":"webhook erp-vendor.updated","title":"Erp vendor updated","href":"/how-to-guides/webhooks/erp/erp-vendor-updated"},{"openapi":"webhook erp-employee.created","title":"Erp employee created","href":"/how-to-guides/webhooks/erp/erp-employee-created"},{"openapi":"webhook erp-employee.updated","title":"Erp employee updated","href":"/how-to-guides/webhooks/erp/erp-employee-updated"}]}]},{"title":"Writing Data","href":"/how-to-guides/programmatic-writes"},{"title":"Trackstar Tags","href":"/how-to-guides/trackstar-tags"},{"title":"Passthrough Requests","href":"/how-to-guides/passthrough-requests"}]},{"group":"Use Cases","pages":[{"title":"Overview","href":"/use-cases/overview"},{"group":"WMS","pages":[{"title":"Order Fulfillment","href":"/use-cases/order-fulfillment"},{"title":"Inventory Management","href":"/use-cases/inventory-management"},{"title":"Shipping Solutions","href":"/use-cases/shipping-solutions"},{"title":"Returns","href":"/use-cases/returns"},{"title":"Warehouse ASNs","href":"/use-cases/warehouse-asns"}]},{"group":"Cart","pages":[{"title":"Cart Order Fulfillment","href":"/use-cases/cart-order-fulfillment"}]},{"group":"Carrier","pages":[{"title":"Carrier Invoice Data","href":"/use-cases/carrier-invoice-data"}]},{"group":"ERP","hidden":true,"pages":[{"title":"ERP Order Management","href":"/use-cases/erp-order-management"}]}]}]},{"tab":"Admin API","pages":[{"title":"Admin API","href":"/api-reference/mgmt/create-link-token"}]},{"tab":"WMS API","pages":[{"title":"WMS API","href":"/api-reference/wms-api/inventory/info"}]},{"tab":"Cart API","pages":[{"title":"Cart API","href":"/api-reference/cart-api/products/info"}]},{"tab":"Carrier API","pages":[{"title":"Carrier API","href":"/api-reference/carrier-api/invoice-line-items/info"}]},{"tab":"ERP API","hidden":true,"pages":[{"title":"ERP API","href":"/api-reference/erp-api/sales-orders/info"}]}]},"basePath":"","title":"Return created - Trackstar","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}