{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OrderProtection","colors":{"primary":"#5B1FD3","light":"#9B9BFD","dark":"#5B1FD3"},"logo":{"light":"https://mintcdn.com/orderprotectioncom/hWJXW3CDmk7aH415/logo/logo-light.png?fit=max\u0026auto=format\u0026n=hWJXW3CDmk7aH415\u0026q=85\u0026s=b559329f3e265ed3e989d25c28a8e911","dark":"https://mintcdn.com/orderprotectioncom/hWJXW3CDmk7aH415/logo/logo-dark.png?fit=max\u0026auto=format\u0026n=hWJXW3CDmk7aH415\u0026q=85\u0026s=19d85b7fcf7ed0ed226b65098a13712b"},"favicon":"https://mintcdn.com/orderprotectioncom/hWJXW3CDmk7aH415/favicon.png?fit=max\u0026auto=format\u0026n=hWJXW3CDmk7aH415\u0026q=85\u0026s=922a5bd784abc0a76e3bea26c2d077db","api":{"openapi":["openapi.yaml","openapi-claims.yaml","openapi-tests.yaml","openapi-metadata.yaml"]},"background":{"color":{"light":"#FFFFFF","dark":"#1B1F27"}},"navbar":{"links":[{"href":"https://discord.gg/4YQeEghMTP","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.orderprotection.com"}},"footer":{"socials":{"github":"https://github.com/orderprotection","linkedin":"https://www.linkedin.com/company/orderprotection"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/4YQeEghMTP"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"orderprotectioncom","hasAudioNarration":false,"actualSubdomain":"orderprotectioncom","customDomains":["docs.orderprotection.com"],"gitSource":{"type":"github","owner":"orderprotection","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad9aa326f446bbc9726dca8","collectionId":"242a9e4d-5a59-47f2-89ac-95f697f0631f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad9aa326f446bbc9726dca8"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ad9aa326f446bbc9726dca8","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Documentation","count":60},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Education Basecamp","count":26},{"language":"default","tag":"Integrations","count":19},{"language":"default","tag":"Developer Platform","count":15},{"language":"default","tag":"Claims","count":14},{"language":"default","tag":"Platforms","count":9},{"language":"default","tag":"Products","count":8},{"language":"default","tag":"Webhooks","count":8},{"language":"default","tag":"Getting Started","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/orders/create-order","slug":"/api-reference/orders/create-order","pageMetadata":{"openapi":"post /v1/orders","title":"Create order","description":null,"href":"/api-reference/orders/create-order"},"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":"post /v1/orders","title":"Create order","description":null,"href":"/api-reference/orders/create-order"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"OrdersApiController_createOrder","summary":"Create order","parameters":[],"requestBody":"de888274-3453-4244-91c7-e892861bf9bb","responses":{"201":"09a05cf8-4888-40b0-9884-3fea80e97135","401":"f213251f-789d-4dd0-9fb7-49b4d50e8e0a","409":"193f9495-9176-4c6b-988c-623b75a8c320"},"tags":["Orders"],"security":["cef83d45-18aa-41da-805f-de3c2304fb86"],"method":"post","type":"path","servers":["9866e00b-2752-42d9-860b-8afbd291ada6"],"path":"/v1/orders","baseUrlOptions":["https://api.production.orderprotection.com"],"title":"Create order","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sourceOrderId","sourceOrderNumber","currency","sourceCreatedAt","total","subtotal","customerEmail","customerName"],"properties":{"sourceOrderId":{"type":"string","example":"#517AB","description":"Order ID on your platform","isRequired":true,"uniqueKey":"sourceOrderId","typeLabel":"string"},"sourceOrderNumber":{"type":"string","example":"#634C","description":"Order Number on your platform","isRequired":true,"uniqueKey":"sourceOrderNumber","typeLabel":"string"},"sourceCreatedAt":{"format":"date-time","type":"string","example":"2000-05-15T21:00:00.000Z","description":"Creation date of the order on your platform","isRequired":true,"uniqueKey":"sourceCreatedAt","typeLabel":"string\u003cdate-time>"},"currency":{"type":"string","example":"USD","enum":["ADP","AED","AFA","AFN","ALK","ALL","AMD","ANG","AOA","AOK","AON","AOR","ARA","ARP","ARS","ARY","ATS","AUD","AWG","AYM","AZM","AZN","BAD","BAM","BBD","BDT","BEC","BEF","BEL","BGJ","BGK","BGL","BGN","BHD","BIF","BMD","BND","BOB","BOP","BOV","BRB","BRC","BRE","BRL","BRN","BRR","BSD","BTN","BUK","BWP","BYB","BYN","BYR","BZD","CAD","CDF","CHC","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CSD","CSJ","CSK","CUC","CUP","CVE","CYP","CZK","DDM","DEM","DJF","DKK","DOP","DZD","ECS","ECV","EEK","EGP","ERN","ESA","ESB","ESP","ETB","EUR","FIM","FJD","FKP","FRF","GBP","GEK","GEL","GHC","GHP","GHS","GIP","GMD","GNE","GNF","GNS","GQE","GRD","GTQ","GWE","GWP","GYD","HKD","HNL","HRD","HRK","HTG","HUF","IDR","IEP","ILP","ILR","ILS","INR","IQD","IRR","ISJ","ISK","ITL","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAJ","LAK","LBP","LKR","LRD","LSL","LSM","LTL","LTT","LUC","LUF","LUL","LVL","LVR","LYD","MAD","MDL","MGA","MGF","MKD","MLF","MMK","MNT","MOP","MRO","MRU","MTL","MTP","MUR","MVQ","MVR","MWK","MXN","MXP","MXV","MYR","MZE","MZM","MZN","NAD","NGN","NIC","NIO","NLG","NOK","NPR","NZD","OMR","PAB","PEH","PEI","PEN","PES","PGK","PHP","PKR","PLN","PLZ","PTE","PYG","QAR","RHD","ROK","ROL","RON","RSD","RUB","RUR","RWF","SAR","SBD","SCR","SDD","SDG","SDP","SEK","SGD","SHP","SIT","SKK","SLL","SOS","SRD","SRG","SSP","STD","STN","SUR","SVC","SYP","SZL","THB","TJR","TJS","TMM","TMT","TND","TOP","TPE","TRL","TRY","TTD","TWD","TZS","UAH","UAK","UGS","UGW","UGX","USD","USN","USS","UYI","UYN","UYP","UYU","UYW","UZS","VEB","VEF","VES","VNC","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XEU","XFO","XFU","XOF","XPD","XPF","XPT","XRE","XSU","XTS","XUA","XXX","YDD","YER","YUD","YUM","YUN","ZAL","ZAR","ZMK","ZMW","ZRN","ZRZ","ZWC","ZWD","ZWL","ZWN","ZWR"],"description":"Order currency","isRequired":true,"uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"total":{"type":"number","example":15.4,"description":"Order total","isRequired":true,"uniqueKey":"total","typeLabel":"number"},"subtotal":{"type":"number","example":11.3,"description":"Order subtotal","isRequired":true,"uniqueKey":"subtotal","typeLabel":"number"},"customerEmail":{"type":"string","example":"john@doe.com","description":"Customer email","isRequired":true,"uniqueKey":"customerEmail","typeLabel":"string"},"customerName":{"type":"string","example":"John","description":"Customer name","isRequired":true,"uniqueKey":"customerName","typeLabel":"string"},"originalSourceOrderId":{"type":"string","example":"12345","description":"If this was a replacement for another Order, you can include the original order id here.","uniqueKey":"originalSourceOrderId","typeLabel":"string"},"sourceUpdatedAt":{"oneOf":[{"format":"date-time","type":"string","example":"2000-05-15T21:00:00.000Z","description":"Updated date of the order on your platform","uniqueKey":"sourceUpdatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"format":"date-time","type":"null","example":"2000-05-15T21:00:00.000Z","description":"Updated date of the order on your platform","uniqueKey":"sourceUpdatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"sourceUpdatedAt","typeLabel":"string\u003cdate-time> | null"},"sourceCancelledAt":{"oneOf":[{"format":"date-time","type":"string","example":"2000-05-15T21:00:00.000Z","description":"Cancellation date of the order on your platform","uniqueKey":"sourceCancelledAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"format":"date-time","type":"null","example":"2000-05-15T21:00:00.000Z","description":"Cancellation date of the order on your platform","uniqueKey":"sourceCancelledAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"sourceCancelledAt","typeLabel":"string\u003cdate-time> | null"},"policyCancelledAt":{"oneOf":[{"format":"date-time","type":"string","example":"2024-03-20T12:00:00.000Z","description":"Date when the policy was cancelled","uniqueKey":"policyCancelledAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"format":"date-time","type":"null","example":"2024-03-20T12:00:00.000Z","description":"Date when the policy was cancelled","uniqueKey":"policyCancelledAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"policyCancelledAt","typeLabel":"string\u003cdate-time> | null"},"platformId":{"type":"string","example":"api","enum":["shopify","woocommerce","magento","bigcommerce","api"],"description":"Platform identifier","uniqueKey":"platformId","typeLabel":"enum\u003cstring>"},"premiumPaid":{"type":"number","example":1.5,"description":"Premium paid after discounts","uniqueKey":"premiumPaid","typeLabel":"number"},"premiumCost":{"type":"number","example":1,"description":"Gross cost of revenue","uniqueKey":"premiumCost","typeLabel":"number"},"premiumDiscount":{"type":"number","example":1,"description":"Premium Discount","uniqueKey":"premiumDiscount","typeLabel":"number"},"discountTotal":{"type":"number","example":1.2,"description":"Order discount","uniqueKey":"discountTotal","typeLabel":"number"},"customerIp":{"oneOf":[{"type":"string","example":"123.123.123.123","description":"Customer IP address","uniqueKey":"customerIp.oneOf.0","typeLabel":"string"},{"type":"null","example":"123.123.123.123","description":"Customer IP address","uniqueKey":"customerIp.oneOf.1","typeLabel":"null"}],"uniqueKey":"customerIp","typeLabel":"string | null"},"exchangeRate":{"oneOf":[{"type":"number","example":1.024,"description":"This should only be set if the store currency is `USD` and the order currency is not `USD`","uniqueKey":"exchangeRate.oneOf.0","typeLabel":"number"},{"type":"null","example":1.024,"description":"This should only be set if the store currency is `USD` and the order currency is not `USD`","uniqueKey":"exchangeRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"exchangeRate","typeLabel":"number | null"},"shippingCost":{"type":"number","example":3.5,"description":"Order shipping cost","uniqueKey":"shippingCost","typeLabel":"number"},"tax":{"type":"number","example":0.55,"description":"Order tax","uniqueKey":"tax","typeLabel":"number"},"customerPhone":{"type":"string","example":"+1-555-796-3644","description":"Customer phone number","uniqueKey":"customerPhone","typeLabel":"string"},"shippingCostTax":{"type":"number","example":234,"description":"Tax associated with shipping","uniqueKey":"shippingCostTax","typeLabel":"number"},"orderItems":{"example":[{"productName":"Handcrafted Wooden Table","productUrl":"https://bogus-clarity.name/","productImage":"https://bogus-clarity.name/product/image.jpg","sku":"978-0-10-081434-9","quantity":4,"price":45.43,"sourceItemId":"387179","sourceProductId":"477353","sourceVariantId":"17742","description":"Variant: White Oak. Size: 10'x10'"},{"productName":"Another prod","productUrl":"https://test.site/","sku":"5555","quantity":4,"price":45.43,"sourceItemId":"387180","sourceProductId":"477353","sourceVariantId":"17742","description":"Variant: White Oak. Size: 10'x10'"}],"description":"Array of product items","type":"array","items":{"type":"object","properties":{"productName":{"type":"string","example":"Handcrafted Soft Mouse","description":"Product name","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].productName","typeLabel":"string"},"productUrl":{"type":"string","example":"https://example.net/product/5","description":"Product URL","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].productUrl","typeLabel":"string"},"productImage":{"type":"string","example":"https://example.net/product/5/image.jpg","description":"Product Image URL","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].productImage","typeLabel":"string"},"sku":{"type":"string","example":"978-0-279-23986-8","description":"Product sku","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].sku","typeLabel":"string"},"quantity":{"type":"number","example":2,"description":"Product quantity","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].quantity","typeLabel":"number"},"price":{"type":"number","example":1050,"description":"Product price","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].price","typeLabel":"number"},"discount":{"type":"number","example":1050,"description":"Product discount","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].discount","typeLabel":"number"},"tax":{"type":"number","example":1050,"description":"Product tax","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].tax","typeLabel":"number"},"sourceItemId":{"type":"string","example":"396568","description":"Product source item id","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].sourceItemId","typeLabel":"string"},"sourceProductId":{"type":"string","example":"164073","description":"Product source product id","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].sourceProductId","typeLabel":"string"},"sourceVariantId":{"type":"string","example":"449493","description":"Product source variant id","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].sourceVariantId","typeLabel":"string"},"itemDescription":{"oneOf":[{"type":"string","example":"Color: White. Size: 12","description":"Product variant information to help determine which item was purchased","uniqueKey":"orderItems.items.[INDEX].itemDescription.oneOf.0","typeLabel":"string"},{"type":"null","example":"Color: White. Size: 12","description":"Product variant information to help determine which item was purchased","uniqueKey":"orderItems.items.[INDEX].itemDescription.oneOf.1","typeLabel":"null"}],"uniqueKey":"orderItems.items.[INDEX].itemDescription","typeLabel":"string | null"},"refundedQuantity":{"type":"number","example":1,"description":"Quantity of items refunded","uniqueKey":"orderItems.items.[INDEX].refundedQuantity","typeLabel":"number"},"selectedOptions":{"example":[{"name":"Size","value":"XS"}],"default":[],"description":"Options associated with a variant. e.g. size, color","type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"Size","description":"Name associated with the selected option. e.g. size, color","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].selectedOptions.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","example":"XL","description":"Value associated with the name e.g. XS, Orange","isRequired":true,"uniqueKey":"orderItems.items.[INDEX].selectedOptions.items.[INDEX].value","typeLabel":"string"}},"required":["name","value"],"uniqueKey":"orderItems.items.[INDEX].selectedOptions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"orderItems.items.[INDEX].selectedOptions","typeLabel":"object[]"}},"required":["productName","productUrl","productImage","sku","quantity","price","discount","tax","sourceItemId","sourceProductId","sourceVariantId"],"uniqueKey":"orderItems.items.[INDEX]","typeLabel":"object"},"uniqueKey":"orderItems","typeLabel":"object[]"},"address":{"type":"array","items":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","type"],"properties":{"firstName":{"type":"string","example":"Milford","isRequired":true,"uniqueKey":"address.items.[INDEX].firstName","typeLabel":"string"},"lastName":{"type":"string","example":"Mayert","isRequired":true,"uniqueKey":"address.items.[INDEX].lastName","typeLabel":"string"},"address1":{"type":"string","example":"991 Nicolas Landing","isRequired":true,"uniqueKey":"address.items.[INDEX].address1","typeLabel":"string"},"city":{"type":"string","example":"Rippinfurt","isRequired":true,"uniqueKey":"address.items.[INDEX].city","typeLabel":"string"},"state":{"type":"string","example":"AZ","isRequired":true,"uniqueKey":"address.items.[INDEX].state","typeLabel":"string"},"zip":{"type":"string","example":"08731","isRequired":true,"uniqueKey":"address.items.[INDEX].zip","typeLabel":"string"},"country":{"type":"string","example":"US","isRequired":true,"uniqueKey":"address.items.[INDEX].country","typeLabel":"string"},"type":{"type":"string","enum":["BILLING","SHIPPING"],"example":"SHIPPING","isRequired":true,"uniqueKey":"address.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"address2":{"oneOf":[{"type":"string","example":"Apt. 796","uniqueKey":"address.items.[INDEX].address2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Apt. 796","uniqueKey":"address.items.[INDEX].address2.oneOf.1","typeLabel":"null"}],"uniqueKey":"address.items.[INDEX].address2","typeLabel":"string | null"},"stateAbr":{"type":"string","example":"AZ","uniqueKey":"address.items.[INDEX].stateAbr","typeLabel":"string"},"lat":{"oneOf":[{"type":"number","example":40.7128,"uniqueKey":"address.items.[INDEX].lat.oneOf.0","typeLabel":"number"},{"type":"null","example":40.7128,"uniqueKey":"address.items.[INDEX].lat.oneOf.1","typeLabel":"null"}],"uniqueKey":"address.items.[INDEX].lat","typeLabel":"number | null"},"lng":{"oneOf":[{"type":"number","example":-74.006,"uniqueKey":"address.items.[INDEX].lng.oneOf.0","typeLabel":"number"},{"type":"null","example":-74.006,"uniqueKey":"address.items.[INDEX].lng.oneOf.1","typeLabel":"null"}],"uniqueKey":"address.items.[INDEX].lng","typeLabel":"number | null"}},"uniqueKey":"address.items.[INDEX]","typeLabel":"object"},"description":"Shipping or Billing Address","uniqueKey":"address","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"sourceOrderId":"#517AB","sourceOrderNumber":"#634C","sourceCreatedAt":"2000-05-15T21:00:00.000Z","currency":"USD","total":15.4,"subtotal":11.3,"customerEmail":"john@doe.com","customerName":"John","originalSourceOrderId":"12345","sourceUpdatedAt":"2000-05-15T21:00:00.000Z","sourceCancelledAt":"2000-05-15T21:00:00.000Z","policyCancelledAt":"2024-03-20T12:00:00.000Z","platformId":"api","premiumPaid":1.5,"premiumCost":1,"premiumDiscount":1,"discountTotal":1.2,"customerIp":"123.123.123.123","exchangeRate":1.024,"shippingCost":3.5,"tax":0.55,"customerPhone":"+1-555-796-3644","shippingCostTax":234,"orderItems":[{"productName":"Handcrafted Wooden Table","productUrl":"https://bogus-clarity.name/","productImage":"https://bogus-clarity.name/product/image.jpg","sku":"978-0-10-081434-9","quantity":4,"price":45.43,"sourceItemId":"387179","sourceProductId":"477353","sourceVariantId":"17742","description":"Variant: White Oak. Size: 10'x10'"},{"productName":"Another prod","productUrl":"https://test.site/","sku":"5555","quantity":4,"price":45.43,"sourceItemId":"387180","sourceProductId":"477353","sourceVariantId":"17742","description":"Variant: White Oak. Size: 10'x10'"}],"address":[{"firstName":"Milford","lastName":"Mayert","address1":"991 Nicolas Landing","city":"Rippinfurt","state":"AZ","zip":"08731","country":"US","type":"SHIPPING","address2":"Apt. 796","stateAbr":"AZ","lat":40.7128,"lng":-74.006}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"09a05cf8-4888-40b0-9884-3fea80e97135":{"description":"The order passes validation and has been successfully created.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","readOnly":true,"deprecated":false,"example":"ok","isRequired":true,"uniqueKey":"status","typeLabel":"string"}},"required":["status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"ok"}}},"exampleType":"generated"}},"exampleType":"generated"},"f213251f-789d-4dd0-9fb7-49b4d50e8e0a":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","readOnly":true,"example":"Unauthorized","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"statusCode":{"type":"number","readOnly":true,"example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"}},"required":["message","statusCode"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Unauthorized","statusCode":401}}},"exampleType":"generated"}},"exampleType":"generated"},"193f9495-9176-4c6b-988c-623b75a8c320":{"description":"Order with same sourceOrderId already exist.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","readOnly":true,"example":"order not found","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","readOnly":true,"example":"Not Found","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"statusCode":{"type":"number","readOnly":true,"example":404,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"}},"required":["message","error","statusCode"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"order not found","error":"Not Found","statusCode":404}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"cef83d45-18aa-41da-805f-de3c2304fb86":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","scopes":[]}}},"servers":{"9866e00b-2752-42d9-860b-8afbd291ada6":{"url":"https://api.production.orderprotection.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","bearerFormat":"JWT","type":"http","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"orderprotectioncom","siteName":"OrderProtection","title":"Create order - OrderProtection","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T22:04:31.558Z","originalFileLocation":"api-reference/orders/create-order.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=\"application-name\" content=\"OrderProtection\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/orderprotectioncom/fpSHGzgH5R5IA_DO/_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/orderprotectioncom/fpSHGzgH5R5IA_DO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/orderprotectioncom/fpSHGzgH5R5IA_DO/_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/orderprotectioncom/fpSHGzgH5R5IA_DO/_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/orderprotectioncom/fpSHGzgH5R5IA_DO/_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/orderprotectioncom/fpSHGzgH5R5IA_DO/_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/orderprotectioncom/fpSHGzgH5R5IA_DO/_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/orderprotectioncom/fpSHGzgH5R5IA_DO/_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/orderprotectioncom/fpSHGzgH5R5IA_DO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create order - OrderProtection\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OrderProtection\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.orderprotection.com/api-reference/orders/create-order\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://orderprotectioncom.mintlify.app/_mintlify/api/og/v2?division=Orders\u0026amp;title=Create+order\u0026amp;theme=1ad0a6091eaf8edb368a13c9\u0026amp;signature=589c4785f57569c2e16a3225fe135ffe6b78308dea3844cf69bee8784832631b\">\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=\"Create order - OrderProtection\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://orderprotectioncom.mintlify.app/_mintlify/api/og/v2?division=Orders\u0026amp;title=Create+order\u0026amp;theme=1ad0a6091eaf8edb368a13c9\u0026amp;signature=589c4785f57569c2e16a3225fe135ffe6b78308dea3844cf69bee8784832631b\">\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/orderprotectioncom/fpSHGzgH5R5IA_DO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OrderProtection\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5B1FD3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.orderprotection.com/api-reference/orders/create-order\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/orders/create-order.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.orderprotection.com/#organization\",\"name\":\"OrderProtection\",\"url\":\"https://docs.orderprotection.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/orderprotectioncom/hWJXW3CDmk7aH415/logo/logo-light.png?fit=max\u0026auto=format\u0026n=hWJXW3CDmk7aH415\u0026q=85\u0026s=b559329f3e265ed3e989d25c28a8e911\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.orderprotection.com#website\",\"name\":\"OrderProtection\",\"url\":\"https://docs.orderprotection.com\",\"publisher\":{\"@id\":\"https://docs.orderprotection.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.orderprotection.com/api-reference/orders/create-order#webpage\",\"url\":\"https://docs.orderprotection.com/api-reference/orders/create-order\",\"name\":\"Create order\",\"dateModified\":\"2026-10-07T22:04:31.558Z\",\"isPartOf\":{\"@id\":\"https://docs.orderprotection.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.orderprotection.com/api-reference/orders/create-order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.orderprotection.com/api-reference/orders/create-order#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Orders\",\"item\":\"https://docs.orderprotection.com/api-reference/orders/get-order-by-source-id\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create order\",\"item\":\"https://docs.orderprotection.com/api-reference/orders/create-order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.orderprotection.com/api-reference/orders/create-order#apireference\",\"headline\":\"Create order\",\"name\":\"Create order\",\"url\":\"https://docs.orderprotection.com/api-reference/orders/create-order\",\"mainEntityOfPage\":{\"@id\":\"https://docs.orderprotection.com/api-reference/orders/create-order#webpage\"},\"dateModified\":\"2026-10-07T22:04:31.558Z\",\"publisher\":{\"@id\":\"https://docs.orderprotection.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.orderprotection.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OrderProtection\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OrderProtection","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.gg/4YQeEghMTP"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Orders","pages":[{"openapi":"GET /v1/orders/{sourceOrderId}","title":"Retrieve Order","href":"/api-reference/orders/get-order-by-source-id"},{"openapi":"put /v1/orders/{sourceOrderId}","title":"Update order","href":"/api-reference/orders/update-order"},{"openapi":"delete /v1/orders/{sourceOrderId}","title":"Delete order","href":"/api-reference/orders/delete-order"},{"openapi":"get /v1/orders","title":"List Orders","description":null,"href":"/api-reference/orders/get-all-orders"},{"openapi":"post /v1/orders","title":"Create order","href":"/api-reference/orders/create-order"}]},{"group":"Fulfillments","pages":[{"openapi":"get /v1/orders/{sourceOrderId}/fulfillments","title":"Get Fulfillment","description":null,"href":"/api-reference/fulfillments/get-fulfillments-for-order"},{"openapi":"post /v1/orders/{sourceOrderId}/fulfillments","title":"Create Fulfillment","href":"/api-reference/fulfillments/create-fulfillment-for-order"},{"openapi":"put /v1/orders/{sourceOrderId}/fulfillments/{sourceFulfillmentId}","title":"Update Fulfillment","href":"/api-reference/fulfillments/update-fulfillment-for-order"},{"openapi":"delete /v1/orders/{sourceOrderId}/fulfillments/{sourceFulfillmentId}","title":"Delete Fulfillment","href":"/api-reference/fulfillments/delete-fulfillment-for-order"}]},{"group":"Claims","pages":[{"title":"Create Online Claim","openapi":"openapi-claims POST /v1/claims/{sourceOrderId}","href":"/api-reference/claims/create-online-claim"},{"title":"Create Offline Claim","openapi":"openapi-claims POST /v1/claims/offline","href":"/api-reference/claims/create-offline-claim"},{"title":"Get Claims","openapi":"openapi-claims GET /v1/claims","href":"/api-reference/claims/get-claims"},{"title":"Get Claims By Order","openapi":"openapi-claims GET /v1/orders/{sourceOrderId}/claims","href":"/api-reference/claims/get-claims-by-order"}]},{"group":"Metadata","pages":[{"title":"Retrieve order metadata","openapi":"openapi-metadata GET /v1/orders/metadata/{id}","href":"/api-reference/metadata/get-metadata"},{"title":"Add metadata","openapi":"openapi-metadata POST /v1/orders/metadata/{id}","href":"/api-reference/metadata/add-metadata"},{"title":"Update metadata","openapi":"openapi-metadata PUT /v1/orders/metadata/{id}/{key}","href":"/api-reference/metadata/update-metadata"},{"title":"Delete metadata","openapi":"openapi-metadata DELETE /v1/orders/metadata/{id}/{key}","href":"/api-reference/metadata/delete-metadata"}]},{"group":"Products","pages":[{"title":"Create Product","openapi":"openapi-products POST /v2/products","href":"/api-reference/products/create-product"},{"title":"Get Product","openapi":"openapi-products GET /v2/products/{productId}","href":"/api-reference/products/get-product"},{"title":"Update Product","openapi":"openapi-products PUT /v2/products/{productId}","href":"/api-reference/products/update-product"},{"title":"Delete Product","openapi":"openapi-products DELETE /v2/products/{productId}","href":"/api-reference/products/delete-product"},{"title":"Add Product Child","openapi":"openapi-products POST /v2/products/{productId}/children","href":"/api-reference/products/add-variant"},{"title":"Remove Product Child","openapi":"openapi-products DELETE /v2/products/{productId}/children/{childId}","href":"/api-reference/products/remove-variant"},{"title":"Add product to bundle","openapi":"openapi-products POST /v2/products/{productId}/bundle","href":"/api-reference/products/add-product-to-bundle"},{"title":"Remove product from bundle","openapi":"openapi-products POST /v2/products/{productId}/bundle/remove","href":"/api-reference/products/remove-product-from-bundle"}]},{"group":"Quote","pages":[{"title":"Get Insurance Quote","openapi":"openapi-quote GET /v1/quote/insurance?store_url={store_url}","href":"/api-reference/quote/get-quote"}]},{"group":"Tests","pages":[{"title":"List Tests","openapi":"openapi-tests GET /v1/split-tests","href":"/api-reference/tests/tests"},{"title":"Get Test Events","openapi":"openapi-tests GET /v1/split-tests/{id}/events","href":"/api-reference/tests/test-events"}]}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/webhooks/introduction"}]},{"tab":"Developer Platform","pages":[{"title":"Developer Platform","href":"/developer/introduction"}]}]},"basePath":"","title":"Create order - OrderProtection","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}