If you also sell through Shopify, send the buyer’s Shopify customer ID as shopify_customer_id. When that buyer’s Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer’s first Shopify order syncs.
If a customer already has that Shopify customer ID, you get that customer back with a 200 and nothing is created or changed. So it’s safe to send the same create twice.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Streamlined","description":"Streamlined B2B invoicing and payments API. Create invoices, track payments, reconcile, and sync with Shopify and QuickBooks, from code or AI agents.","colors":{"primary":"#7344E6","light":"#9A69FF","dark":"#7344E6"},"logo":{"light":"https://mintcdn.com/streamlined/Qpdci2P6MxdROfbH/logo/dark-full-logo.svg?fit=max\u0026auto=format\u0026n=Qpdci2P6MxdROfbH\u0026q=85\u0026s=8fc069947772cc7f34a667a4ac44277e","dark":"https://mintcdn.com/streamlined/Qpdci2P6MxdROfbH/logo/white-full-logo.svg?fit=max\u0026auto=format\u0026n=Qpdci2P6MxdROfbH\u0026q=85\u0026s=65b5117ce25c03613743c300e70088f2","href":"https://www.streamlinedpayments.com"},"favicon":"https://mintcdn.com/streamlined/Qpdci2P6MxdROfbH/favicon.png?fit=max\u0026auto=format\u0026n=Qpdci2P6MxdROfbH\u0026q=85\u0026s=1f91eaeb7c352eb35379da9dc5bc4141","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python","ruby"]}},"background":{"color":{"light":"#FFFFFF","dark":"#1A1B1F"}},"navbar":{"links":[{"href":"https://www.streamlinedpayments.com","label":"streamlinedpayments.com"}]},"footer":{"socials":{"website":"https://www.streamlinedpayments.com"}},"seo":{"metatags":{"canonical":"https://docs.streamlinedpayments.com"}},"icons":{"library":"tabler"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"streamlined","hasAudioNarration":false,"actualSubdomain":"streamlined","customDomains":["docs.streamlinedpayments.com"],"gitSource":{"type":"github","owner":"streamlined","repo":"api-docs","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":"","_id":"6ade5ab7087fb56429740964"},"chroma":{"latestBuiltDeploymentHistoryId":"6ade6405793cfd8b52fb7a45","collectionId":"2c339057-d55e-4de5-bf20-9b98106b8ca8","liveDeploymentHistoryId":"6ade6405793cfd8b52fb7a45","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ade9510a5087fd650ccab9a","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API reference","count":68},{"language":"default","tag":"Webhooks","count":10},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Orders","count":9},{"language":"default","tag":"Products","count":9},{"language":"default","tag":"Customer groups","count":7},{"language":"default","tag":"Customer addresses","count":6},{"language":"default","tag":"Deposit links","count":6},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"Customer files","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/customers/create-customer","slug":"/api-reference/customers/create-customer","pageMetadata":{"title":"Create customer","description":"Creates a new customer.\n\nIf you also sell through Shopify, send the buyer's Shopify customer ID as `shopify_customer_id`. When that buyer's Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer's first Shopify order syncs.\n\nIf a customer already has that Shopify customer ID, you get that customer back with a `200` and nothing is created or changed. So it's safe to send the same create twice.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /customers","href":"/api-reference/customers/create-customer","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Creates a new customer.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"If you also sell through Shopify, send the buyer’s Shopify customer ID as \", _jsx(_components.code, {\n children: \"shopify_customer_id\"\n }), \". When that buyer’s Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer’s first Shopify order syncs.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"If a customer already has that Shopify customer ID, you get that customer back with a \", _jsx(_components.code, {\n children: \"200\"\n }), \" and nothing is created or changed. So it’s safe to send the same create twice.\"]\n })]\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":{"title":"Create customer","description":"Creates a new customer.\n\nIf you also sell through Shopify, send the buyer's Shopify customer ID as `shopify_customer_id`. When that buyer's Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer's first Shopify order syncs.\n\nIf a customer already has that Shopify customer ID, you get that customer back with a `200` and nothing is created or changed. So it's safe to send the same create twice.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /customers","href":"/api-reference/customers/create-customer","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Customers"],"summary":"Create customer","description":"Creates a new customer.\n\nIf you also sell through Shopify, send the buyer's Shopify customer ID as `shopify_customer_id`. When that buyer's Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer's first Shopify order syncs.\n\nIf a customer already has that Shopify customer ID, you get that customer back with a `200` and nothing is created or changed. So it's safe to send the same create twice.\n","operationId":"createCustomer","requestBody":"645a1828-fc50-4262-a9a5-4688615e33f0","responses":{"200":"9ecf135f-4d62-413e-a63a-6376d27524d7","201":"7e157aed-b013-43e6-be37-b7aa782a5b68","400":"33bba97a-8e41-45a3-a71f-d078b5303f76","401":"ecf0fe98-a356-441e-bb62-2d80c1a894bf","422":"cad22610-e5f6-41c7-9adb-dcf85be17bab"},"method":"post","type":"path","servers":["14bef3eb-4da6-4f98-a900-b553c1226ab6","b7355531-eb15-408a-831a-58d29a90c2c3"],"security":["086c9871-1b00-4a03-8647-4da3ba7b7947"],"path":"/customers","baseUrlOptions":["https://api.staging.streamlinedpayments.com/api/v1","https://api.streamlinedpayments.com/api/v1"],"title":"Create customer","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["customer"],"properties":{"customer":{"type":"object","properties":{"first_name":{"type":"string","description":"First name of the customer","uniqueKey":"customer.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Last name of the customer","uniqueKey":"customer.last_name","typeLabel":"string"},"company_name":{"type":"string","description":"Company name of the customer","uniqueKey":"customer.company_name","typeLabel":"string"},"website":{"type":"string","description":"Website of the customer","uniqueKey":"customer.website","typeLabel":"string"},"tags":{"type":"string","description":"Tags for the customer (comma-separated)","uniqueKey":"customer.tags","typeLabel":"string"},"tax_exempt":{"type":"boolean","description":"Whether the customer is tax exempt","uniqueKey":"customer.tax_exempt","typeLabel":"boolean"},"net_terms":{"oneOf":[{"type":"integer","enum":[0,7,10,15,30,45,60,90],"description":"Payment terms in days. 0 = Due on receipt. null = inherit from customer group, then merchant default.\nOnly the listed values are accepted.\n","uniqueKey":"customer.net_terms.oneOf.0","typeLabel":"enum\u003cinteger>"},{"type":"null","enum":[0,7,10,15,30,45,60,90],"description":"Payment terms in days. 0 = Due on receipt. null = inherit from customer group, then merchant default.\nOnly the listed values are accepted.\n","uniqueKey":"customer.net_terms.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.net_terms","typeLabel":"enum\u003cinteger> | null"},"customer_group_uuid":{"oneOf":[{"type":"string","format":"uuid","description":"UUID of the customer group to associate this customer with. null removes from any group.","uniqueKey":"customer.customer_group_uuid.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"UUID of the customer group to associate this customer with. null removes from any group.","uniqueKey":"customer.customer_group_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.customer_group_uuid","typeLabel":"string\u003cuuid> | null"},"shopify_customer_id":{"type":"string","description":"The buyer's Shopify customer ID, as a number (`1234567890`) or a GID (`gid://shopify/Customer/1234567890`). Stored and returned as a GID.\n","example":"1234567890","uniqueKey":"customer.shopify_customer_id","typeLabel":"string"},"shopify_shop_domain":{"type":"string","description":"The Shopify store the customer belongs to, like `your-store` or `your-store.myshopify.com`. Required when more than one Shopify store is connected to your account. Only used with `shopify_customer_id`.\n","example":"your-store","uniqueKey":"customer.shopify_shop_domain","typeLabel":"string"},"addresses_attributes":{"type":"array","items":{"type":"object","properties":{"address1":{"type":"string","description":"First line of the address","uniqueKey":"customer.addresses_attributes.items.[INDEX].address1","typeLabel":"string"},"address2":{"type":"string","description":"Second line of the address","uniqueKey":"customer.addresses_attributes.items.[INDEX].address2","typeLabel":"string"},"city":{"type":"string","description":"City","uniqueKey":"customer.addresses_attributes.items.[INDEX].city","typeLabel":"string"},"state":{"type":"string","description":"State or province","uniqueKey":"customer.addresses_attributes.items.[INDEX].state","typeLabel":"string"},"postal_code":{"type":"string","description":"Postal code","uniqueKey":"customer.addresses_attributes.items.[INDEX].postal_code","typeLabel":"string"},"country":{"type":"string","description":"Country","uniqueKey":"customer.addresses_attributes.items.[INDEX].country","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Email address","uniqueKey":"customer.addresses_attributes.items.[INDEX].email","typeLabel":"string\u003cemail>"},"cc_email":{"type":"string","format":"email","description":"CC email addresses (comma-separated list)","uniqueKey":"customer.addresses_attributes.items.[INDEX].cc_email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Phone number","uniqueKey":"customer.addresses_attributes.items.[INDEX].phone","typeLabel":"string"},"first_name":{"type":"string","description":"First name for the address","uniqueKey":"customer.addresses_attributes.items.[INDEX].first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Last name for the address","uniqueKey":"customer.addresses_attributes.items.[INDEX].last_name","typeLabel":"string"},"company_name":{"type":"string","description":"Company name for the address","uniqueKey":"customer.addresses_attributes.items.[INDEX].company_name","typeLabel":"string"}},"uniqueKey":"customer.addresses_attributes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"customer.addresses_attributes","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"customer","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customer":{"first_name":"\u003cstring>","last_name":"\u003cstring>","company_name":"\u003cstring>","website":"\u003cstring>","tags":"\u003cstring>","tax_exempt":true,"customer_group_uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","shopify_customer_id":"1234567890","shopify_shop_domain":"your-store","addresses_attributes":[{"address1":"\u003cstring>","address2":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postal_code":"\u003cstring>","country":"\u003cstring>","email":"jsmith@example.com","cc_email":"jsmith@example.com","phone":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","company_name":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"9ecf135f-4d62-413e-a63a-6376d27524d7":{"description":"A customer already has this `shopify_customer_id`. That customer is returned unchanged.","content":{"application/json":{"schema":{"type":"object","properties":{"customer":{"type":"object","properties":{"website":{"type":"string","uniqueKey":"customer.website","typeLabel":"string"},"company_name":{"type":"string","uniqueKey":"customer.company_name","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","uniqueKey":"customer.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"customer.updated_at","typeLabel":"string\u003cdate-time>"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"customer.tags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"customer.tags","typeLabel":"string[]"},"first_name":{"type":"string","uniqueKey":"customer.first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"customer.last_name","typeLabel":"string"},"uuid":{"type":"string","format":"uuid","uniqueKey":"customer.uuid","typeLabel":"string\u003cuuid>"},"display_name":{"type":"string","uniqueKey":"customer.display_name","typeLabel":"string"},"customer_email":{"type":"string","uniqueKey":"customer.customer_email","typeLabel":"string"},"total_open_balance_amount":{"type":"integer","uniqueKey":"customer.total_open_balance_amount","typeLabel":"integer"},"quick_pay_enabled":{"type":"boolean","uniqueKey":"customer.quick_pay_enabled","typeLabel":"boolean"},"average_days_to_pay":{"type":"integer","uniqueKey":"customer.average_days_to_pay","typeLabel":"integer"},"net_terms":{"oneOf":[{"type":"integer","enum":[0,7,10,15,30,45,60,90],"description":"Payment terms in days. null means inherit from customer group, then merchant default.","uniqueKey":"customer.net_terms.oneOf.0","typeLabel":"enum\u003cinteger>"},{"type":"null","enum":[0,7,10,15,30,45,60,90],"description":"Payment terms in days. null means inherit from customer group, then merchant default.","uniqueKey":"customer.net_terms.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.net_terms","typeLabel":"enum\u003cinteger> | null"},"net_terms_label":{"oneOf":[{"type":"string","description":"Human-readable label for net_terms (e.g. \"Net 30\", \"Due on receipt\").","uniqueKey":"customer.net_terms_label.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable label for net_terms (e.g. \"Net 30\", \"Due on receipt\").","uniqueKey":"customer.net_terms_label.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.net_terms_label","typeLabel":"string | null"},"shopify_customer_id":{"oneOf":[{"type":"string","description":"The Shopify customer this customer is linked to, as a GID. null if not linked.","example":"gid://shopify/Customer/1234567890","uniqueKey":"customer.shopify_customer_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The Shopify customer this customer is linked to, as a GID. null if not linked.","example":"gid://shopify/Customer/1234567890","uniqueKey":"customer.shopify_customer_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.shopify_customer_id","typeLabel":"string | null"},"shopify_shop_domain":{"oneOf":[{"type":"string","description":"The Shopify store the linked Shopify customer belongs to. null if not linked.","example":"your-store","uniqueKey":"customer.shopify_shop_domain.oneOf.0","typeLabel":"string"},{"type":"null","description":"The Shopify store the linked Shopify customer belongs to. null if not linked.","example":"your-store","uniqueKey":"customer.shopify_shop_domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.shopify_shop_domain","typeLabel":"string | null"},"application_submitted_at":{"oneOf":[{"type":"string","format":"date-time","description":"null if the customer never applied.","uniqueKey":"customer.application_submitted_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"null if the customer never applied.","uniqueKey":"customer.application_submitted_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.application_submitted_at","typeLabel":"string\u003cdate-time> | null"},"application_approved_at":{"oneOf":[{"type":"string","format":"date-time","description":"null until the application is approved.","uniqueKey":"customer.application_approved_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"null until the application is approved.","uniqueKey":"customer.application_approved_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.application_approved_at","typeLabel":"string\u003cdate-time> | null"},"customer_group":{"oneOf":[{"type":"object","description":"The group this customer belongs to, if any.","properties":{"uuid":{"type":"string","format":"uuid","uniqueKey":"customer.customer_group.oneOf.0.uuid","typeLabel":"string\u003cuuid>"},"company_name":{"type":"string","uniqueKey":"customer.customer_group.oneOf.0.company_name","typeLabel":"string"}},"uniqueKey":"customer.customer_group.oneOf.0","typeLabel":"object"},{"type":"null","description":"The group this customer belongs to, if any.","properties":{"uuid":{"type":"string","format":"uuid"},"company_name":{"type":"string"}},"uniqueKey":"customer.customer_group.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.customer_group","typeLabel":"object | null"},"billing_address":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"customer.billing_address.id","typeLabel":"integer"},"address1":{"type":"string","uniqueKey":"customer.billing_address.address1","typeLabel":"string"},"address2":{"type":"string","uniqueKey":"customer.billing_address.address2","typeLabel":"string"},"city":{"type":"string","uniqueKey":"customer.billing_address.city","typeLabel":"string"},"state":{"type":"string","uniqueKey":"customer.billing_address.state","typeLabel":"string"},"postal_code":{"type":"string","uniqueKey":"customer.billing_address.postal_code","typeLabel":"string"},"phone":{"type":"string","uniqueKey":"customer.billing_address.phone","typeLabel":"string"},"country":{"type":"string","uniqueKey":"customer.billing_address.country","typeLabel":"string"},"email":{"type":"string","uniqueKey":"customer.billing_address.email","typeLabel":"string"},"cc_email":{"type":"string","description":"CC email addresses (comma-separated list)","uniqueKey":"customer.billing_address.cc_email","typeLabel":"string"},"first_name":{"type":"string","uniqueKey":"customer.billing_address.first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"customer.billing_address.last_name","typeLabel":"string"},"company_name":{"type":"string","uniqueKey":"customer.billing_address.company_name","typeLabel":"string"}},"uniqueKey":"customer.billing_address","typeLabel":"object"},"addresses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"customer.addresses.items.[INDEX].id","typeLabel":"integer"},"address1":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].address1","typeLabel":"string"},"address2":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].address2","typeLabel":"string"},"city":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].city","typeLabel":"string"},"state":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].state","typeLabel":"string"},"postal_code":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].postal_code","typeLabel":"string"},"phone":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].phone","typeLabel":"string"},"country":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].country","typeLabel":"string"},"email":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].email","typeLabel":"string"},"cc_email":{"type":"string","description":"CC email addresses (comma-separated list)","uniqueKey":"customer.addresses.items.[INDEX].cc_email","typeLabel":"string"},"first_name":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].last_name","typeLabel":"string"},"company_name":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].company_name","typeLabel":"string"}},"uniqueKey":"customer.addresses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"customer.addresses","typeLabel":"object[]"}},"uniqueKey":"customer","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customer":{"website":"\u003cstring>","company_name":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","tags":["\u003cstring>"],"first_name":"\u003cstring>","last_name":"\u003cstring>","uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","display_name":"\u003cstring>","customer_email":"\u003cstring>","total_open_balance_amount":123,"quick_pay_enabled":true,"average_days_to_pay":123,"net_terms":0,"net_terms_label":"\u003cstring>","shopify_customer_id":"gid://shopify/Customer/1234567890","shopify_shop_domain":"your-store","application_submitted_at":"2023-11-07T05:31:56Z","application_approved_at":"2023-11-07T05:31:56Z","customer_group":{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","company_name":"\u003cstring>"},"billing_address":{"id":123,"address1":"\u003cstring>","address2":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postal_code":"\u003cstring>","phone":"\u003cstring>","country":"\u003cstring>","email":"\u003cstring>","cc_email":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","company_name":"\u003cstring>"},"addresses":[{"id":123,"address1":"\u003cstring>","address2":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postal_code":"\u003cstring>","phone":"\u003cstring>","country":"\u003cstring>","email":"\u003cstring>","cc_email":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","company_name":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"7e157aed-b013-43e6-be37-b7aa782a5b68":{"description":"Customer created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"customer":{"type":"object","properties":{"website":{"type":"string","uniqueKey":"customer.website","typeLabel":"string"},"company_name":{"type":"string","uniqueKey":"customer.company_name","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","uniqueKey":"customer.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"customer.updated_at","typeLabel":"string\u003cdate-time>"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"customer.tags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"customer.tags","typeLabel":"string[]"},"first_name":{"type":"string","uniqueKey":"customer.first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"customer.last_name","typeLabel":"string"},"uuid":{"type":"string","format":"uuid","uniqueKey":"customer.uuid","typeLabel":"string\u003cuuid>"},"display_name":{"type":"string","uniqueKey":"customer.display_name","typeLabel":"string"},"customer_email":{"type":"string","uniqueKey":"customer.customer_email","typeLabel":"string"},"total_open_balance_amount":{"type":"integer","uniqueKey":"customer.total_open_balance_amount","typeLabel":"integer"},"quick_pay_enabled":{"type":"boolean","uniqueKey":"customer.quick_pay_enabled","typeLabel":"boolean"},"average_days_to_pay":{"type":"integer","uniqueKey":"customer.average_days_to_pay","typeLabel":"integer"},"net_terms":{"oneOf":[{"type":"integer","enum":[0,7,10,15,30,45,60,90],"description":"Payment terms in days. null means inherit from customer group, then merchant default.","uniqueKey":"customer.net_terms.oneOf.0","typeLabel":"enum\u003cinteger>"},{"type":"null","enum":[0,7,10,15,30,45,60,90],"description":"Payment terms in days. null means inherit from customer group, then merchant default.","uniqueKey":"customer.net_terms.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.net_terms","typeLabel":"enum\u003cinteger> | null"},"net_terms_label":{"oneOf":[{"type":"string","description":"Human-readable label for net_terms (e.g. \"Net 30\", \"Due on receipt\").","uniqueKey":"customer.net_terms_label.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable label for net_terms (e.g. \"Net 30\", \"Due on receipt\").","uniqueKey":"customer.net_terms_label.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.net_terms_label","typeLabel":"string | null"},"shopify_customer_id":{"oneOf":[{"type":"string","description":"The Shopify customer this customer is linked to, as a GID. null if not linked.","example":"gid://shopify/Customer/1234567890","uniqueKey":"customer.shopify_customer_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The Shopify customer this customer is linked to, as a GID. null if not linked.","example":"gid://shopify/Customer/1234567890","uniqueKey":"customer.shopify_customer_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.shopify_customer_id","typeLabel":"string | null"},"shopify_shop_domain":{"oneOf":[{"type":"string","description":"The Shopify store the linked Shopify customer belongs to. null if not linked.","example":"your-store","uniqueKey":"customer.shopify_shop_domain.oneOf.0","typeLabel":"string"},{"type":"null","description":"The Shopify store the linked Shopify customer belongs to. null if not linked.","example":"your-store","uniqueKey":"customer.shopify_shop_domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.shopify_shop_domain","typeLabel":"string | null"},"application_submitted_at":{"oneOf":[{"type":"string","format":"date-time","description":"null if the customer never applied.","uniqueKey":"customer.application_submitted_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"null if the customer never applied.","uniqueKey":"customer.application_submitted_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.application_submitted_at","typeLabel":"string\u003cdate-time> | null"},"application_approved_at":{"oneOf":[{"type":"string","format":"date-time","description":"null until the application is approved.","uniqueKey":"customer.application_approved_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"null until the application is approved.","uniqueKey":"customer.application_approved_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.application_approved_at","typeLabel":"string\u003cdate-time> | null"},"customer_group":{"oneOf":[{"type":"object","description":"The group this customer belongs to, if any.","properties":{"uuid":{"type":"string","format":"uuid","uniqueKey":"customer.customer_group.oneOf.0.uuid","typeLabel":"string\u003cuuid>"},"company_name":{"type":"string","uniqueKey":"customer.customer_group.oneOf.0.company_name","typeLabel":"string"}},"uniqueKey":"customer.customer_group.oneOf.0","typeLabel":"object"},{"type":"null","description":"The group this customer belongs to, if any.","properties":{"uuid":{"type":"string","format":"uuid"},"company_name":{"type":"string"}},"uniqueKey":"customer.customer_group.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer.customer_group","typeLabel":"object | null"},"billing_address":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"customer.billing_address.id","typeLabel":"integer"},"address1":{"type":"string","uniqueKey":"customer.billing_address.address1","typeLabel":"string"},"address2":{"type":"string","uniqueKey":"customer.billing_address.address2","typeLabel":"string"},"city":{"type":"string","uniqueKey":"customer.billing_address.city","typeLabel":"string"},"state":{"type":"string","uniqueKey":"customer.billing_address.state","typeLabel":"string"},"postal_code":{"type":"string","uniqueKey":"customer.billing_address.postal_code","typeLabel":"string"},"phone":{"type":"string","uniqueKey":"customer.billing_address.phone","typeLabel":"string"},"country":{"type":"string","uniqueKey":"customer.billing_address.country","typeLabel":"string"},"email":{"type":"string","uniqueKey":"customer.billing_address.email","typeLabel":"string"},"cc_email":{"type":"string","description":"CC email addresses (comma-separated list)","uniqueKey":"customer.billing_address.cc_email","typeLabel":"string"},"first_name":{"type":"string","uniqueKey":"customer.billing_address.first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"customer.billing_address.last_name","typeLabel":"string"},"company_name":{"type":"string","uniqueKey":"customer.billing_address.company_name","typeLabel":"string"}},"uniqueKey":"customer.billing_address","typeLabel":"object"},"addresses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"customer.addresses.items.[INDEX].id","typeLabel":"integer"},"address1":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].address1","typeLabel":"string"},"address2":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].address2","typeLabel":"string"},"city":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].city","typeLabel":"string"},"state":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].state","typeLabel":"string"},"postal_code":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].postal_code","typeLabel":"string"},"phone":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].phone","typeLabel":"string"},"country":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].country","typeLabel":"string"},"email":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].email","typeLabel":"string"},"cc_email":{"type":"string","description":"CC email addresses (comma-separated list)","uniqueKey":"customer.addresses.items.[INDEX].cc_email","typeLabel":"string"},"first_name":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].last_name","typeLabel":"string"},"company_name":{"type":"string","uniqueKey":"customer.addresses.items.[INDEX].company_name","typeLabel":"string"}},"uniqueKey":"customer.addresses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"customer.addresses","typeLabel":"object[]"}},"uniqueKey":"customer","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customer":{"website":"\u003cstring>","company_name":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","tags":["\u003cstring>"],"first_name":"\u003cstring>","last_name":"\u003cstring>","uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","display_name":"\u003cstring>","customer_email":"\u003cstring>","total_open_balance_amount":123,"quick_pay_enabled":true,"average_days_to_pay":123,"net_terms":0,"net_terms_label":"\u003cstring>","shopify_customer_id":"gid://shopify/Customer/1234567890","shopify_shop_domain":"your-store","application_submitted_at":"2023-11-07T05:31:56Z","application_approved_at":"2023-11-07T05:31:56Z","customer_group":{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","company_name":"\u003cstring>"},"billing_address":{"id":123,"address1":"\u003cstring>","address2":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postal_code":"\u003cstring>","phone":"\u003cstring>","country":"\u003cstring>","email":"\u003cstring>","cc_email":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","company_name":"\u003cstring>"},"addresses":[{"id":123,"address1":"\u003cstring>","address2":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","postal_code":"\u003cstring>","phone":"\u003cstring>","country":"\u003cstring>","email":"\u003cstring>","cc_email":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","company_name":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"33bba97a-8e41-45a3-a71f-d078b5303f76":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ecf0fe98-a356-441e-bb62-2d80c1a894bf":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"AuthenticationRequired":{"title":"AuthenticationRequired","value":{"error":"Authentication required","message":"API endpoint requires authentication. Please provide valid X-App-Id and X-Api-Key headers."}},"InvalidCredentials":{"title":"InvalidCredentials","value":{"error":"Invalid credentials","message":"The provided API credentials are invalid. Please check your X-App-Id and X-Api-Key values."}}},"exampleType":"examples"}},"exampleType":"examples"},"cad22610-e5f6-41c7-9adb-dcf85be17bab":{"description":"Unprocessable entity. For `shopify_customer_id` this means the ID isn't a Shopify customer ID, the store isn't connected, `shopify_shop_domain` is missing when you have more than one store, or the ID belongs to a deleted customer.\n","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string","uniqueKey":"errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"086c9871-1b00-4a03-8647-4da3ba7b7947":{"AppIdAuth":{"type":"apiKey","in":"header","name":"X-App-Id","description":"App ID for authentication","scopes":[],"schemeName":"AppIdAuth"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"API Key for authentication","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"14bef3eb-4da6-4f98-a900-b553c1226ab6":{"url":"https://api.staging.streamlinedpayments.com/api/v1","description":"Sandbox"},"b7355531-eb15-408a-831a-58d29a90c2c3":{"url":"https://api.streamlinedpayments.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-App-Id","description":"App ID for authentication","scopes":[],"schemeName":"AppIdAuth"},"schema":{"title":"X-App-Id","type":"string","description":"App ID for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AppIdAuth","name":"X-App-Id"},{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"API Key for authentication","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-Api-Key","type":"string","description":"API Key for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-Api-Key"}],"title":"AppIdAuth \u0026 ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"streamlined","siteName":"Streamlined","title":"Create customer - Streamlined","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-25T20:18:19.388Z","originalFileLocation":"api-reference/customers/create-customer.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=\"Creates a new customer. If you also sell through Shopify, send the buyer\u0026#x27;s Shopify customer ID as shopify_customer_id. When that buyer\u0026#x27;s Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer\u0026#x27;s first Shopify order syncs. If a customer already has that Shopify customer ID, you get that customer back with a 200 and nothing is created or changed. So it\u0026#x27;s safe to send the same create twice.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Streamlined\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/streamlined/URfm7sDwfsC7vQpi/_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/streamlined/URfm7sDwfsC7vQpi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/streamlined/URfm7sDwfsC7vQpi/_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/streamlined/URfm7sDwfsC7vQpi/_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/streamlined/URfm7sDwfsC7vQpi/_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/streamlined/URfm7sDwfsC7vQpi/_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/streamlined/URfm7sDwfsC7vQpi/_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/streamlined/URfm7sDwfsC7vQpi/_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/streamlined/URfm7sDwfsC7vQpi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create customer - Streamlined\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new customer. If you also sell through Shopify, send the buyer\u0026#x27;s Shopify customer ID as shopify_customer_id. When that buyer\u0026#x27;s Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer\u0026#x27;s first Shopify order syncs. If a customer already has that Shopify customer ID, you get that customer back with a 200 and nothing is created or changed. So it\u0026#x27;s safe to send the same create twice.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Streamlined\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://streamlined.mintlify.app/_mintlify/api/og/v2?division=Customers\u0026amp;title=Create+customer\u0026amp;description=Creates+a+new+customer.%0A%0AIf+you+also+sell+through+Shopify%2C+send+the+buyer%27s+Shopify+customer+ID+as+%60shopify_customer_id%60.+When+that+buyer%27s+Shopify+orders+sync%2C\u0026amp;theme=6162774cbdf31784f6455291\u0026amp;signature=35b2b9126771d952d2a0f936d50305fed08dce04e80dd75ee6a3620b8b51e618\">\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 customer - Streamlined\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new customer. If you also sell through Shopify, send the buyer\u0026#x27;s Shopify customer ID as shopify_customer_id. When that buyer\u0026#x27;s Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer\u0026#x27;s first Shopify order syncs. If a customer already has that Shopify customer ID, you get that customer back with a 200 and nothing is created or changed. So it\u0026#x27;s safe to send the same create twice.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://streamlined.mintlify.app/_mintlify/api/og/v2?division=Customers\u0026amp;title=Create+customer\u0026amp;description=Creates+a+new+customer.%0A%0AIf+you+also+sell+through+Shopify%2C+send+the+buyer%27s+Shopify+customer+ID+as+%60shopify_customer_id%60.+When+that+buyer%27s+Shopify+orders+sync%2C\u0026amp;theme=6162774cbdf31784f6455291\u0026amp;signature=35b2b9126771d952d2a0f936d50305fed08dce04e80dd75ee6a3620b8b51e618\">\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/streamlined/URfm7sDwfsC7vQpi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Streamlined\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7344E6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/customers/create-customer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.streamlinedpayments.com/#organization\",\"name\":\"Streamlined\",\"url\":\"https://docs.streamlinedpayments.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/streamlined/Qpdci2P6MxdROfbH/logo/dark-full-logo.svg?fit=max\u0026auto=format\u0026n=Qpdci2P6MxdROfbH\u0026q=85\u0026s=8fc069947772cc7f34a667a4ac44277e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.streamlinedpayments.com#website\",\"name\":\"Streamlined\",\"url\":\"https://docs.streamlinedpayments.com\",\"publisher\":{\"@id\":\"https://docs.streamlinedpayments.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer#webpage\",\"url\":\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer\",\"name\":\"Create customer\",\"description\":\"Creates a new customer. If you also sell through Shopify, send the buyer's Shopify customer ID as shopify_customer_id. When that buyer's Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer's first Shopify order syncs. If a customer already has that Shopify customer ID, you get that customer back with a 200 and nothing is created or changed. So it's safe to send the same create twice.\",\"dateModified\":\"2026-10-25T20:18:19.388Z\",\"isPartOf\":{\"@id\":\"https://docs.streamlinedpayments.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Customers\",\"item\":\"https://docs.streamlinedpayments.com/api-reference/customers/list-customers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create customer\",\"item\":\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer#apireference\",\"headline\":\"Create customer\",\"name\":\"Create customer\",\"description\":\"Creates a new customer. If you also sell through Shopify, send the buyer's Shopify customer ID as shopify_customer_id. When that buyer's Shopify orders sync, they attach to this customer instead of creating a new one. Set it before the buyer's first Shopify order syncs. If a customer already has that Shopify customer ID, you get that customer back with a 200 and nothing is created or changed. So it's safe to send the same create twice.\",\"url\":\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer\",\"mainEntityOfPage\":{\"@id\":\"https://docs.streamlinedpayments.com/api-reference/customers/create-customer#webpage\"},\"dateModified\":\"2026-10-25T20:18:19.388Z\",\"publisher\":{\"@id\":\"https://docs.streamlinedpayments.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.streamlinedpayments.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Streamlined\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Streamlined","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Orders","pages":[{"title":"List orders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /orders","href":"/api-reference/orders/list-orders"},{"title":"Create order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /orders","href":"/api-reference/orders/create-order"},{"title":"Get order details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /orders/{id}","href":"/api-reference/orders/get-order-details"},{"title":"Update order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /orders/{id}","href":"/api-reference/orders/update-order"},{"title":"Delete order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /orders/{id}","href":"/api-reference/orders/delete-order"},{"title":"List scheduled orders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /orders/scheduled","href":"/api-reference/orders/list-scheduled-orders"},{"title":"Add line item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /orders/{id}/line_items","href":"/api-reference/orders/add-line-item"},{"title":"Remove line item","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /orders/{id}/line_items/{line_item_id}","href":"/api-reference/orders/remove-line-item"},{"title":"Schedule order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /orders/{id}/schedule","href":"/api-reference/orders/schedule-order"}]},{"group":"Customers","pages":[{"title":"List customers","description":"Retrieves a paginated list of customers.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customers","href":"/api-reference/customers/list-customers"},{"title":"Create customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /customers","href":"/api-reference/customers/create-customer"},{"title":"Get customer details","description":"Retrieves detailed information about a specific customer.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customers/{uuid}","href":"/api-reference/customers/get-customer-details"},{"title":"Update customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /customers/{uuid}","href":"/api-reference/customers/update-customer"},{"title":"Delete customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /customers/{uuid}","href":"/api-reference/customers/delete-customer"}]},{"group":"Customer applications","pages":[{"title":"List customer applications","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customer_applications","href":"/api-reference/customer-applications/list-customer-applications"},{"title":"Approve customer application","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /customer_applications/{uuid}/approve","href":"/api-reference/customer-applications/approve-customer-application"}]},{"group":"Customer groups","pages":[{"title":"List customer groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customer_groups","href":"/api-reference/customer-groups/list-customer-groups"},{"title":"Create customer group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /customer_groups","href":"/api-reference/customer-groups/create-customer-group"},{"title":"Get customer group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customer_groups/{uuid}","href":"/api-reference/customer-groups/get-customer-group"},{"title":"Update customer group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /customer_groups/{uuid}","href":"/api-reference/customer-groups/update-customer-group"},{"title":"List group members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customer_groups/{uuid}/members","href":"/api-reference/customer-groups/list-group-members"},{"title":"Add members to group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /customer_groups/{uuid}/members","href":"/api-reference/customer-groups/add-members-to-group"},{"title":"Remove members from group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /customer_groups/{uuid}/members","href":"/api-reference/customer-groups/remove-members-from-group"}]},{"group":"Customer files","pages":[{"title":"List customer files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customers/{customer_id}/files","href":"/api-reference/customer-files/list-customer-files"},{"title":"Upload customer file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /customers/{customer_id}/files","href":"/api-reference/customer-files/upload-customer-file"},{"title":"Get customer file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customers/{customer_id}/files/{id}","href":"/api-reference/customer-files/get-customer-file"},{"title":"Update customer file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /customers/{customer_id}/files/{id}","href":"/api-reference/customer-files/update-customer-file"},{"title":"Delete customer file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /customers/{customer_id}/files/{id}","href":"/api-reference/customer-files/delete-customer-file"}]},{"group":"Customer addresses","pages":[{"title":"List customer addresses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customers/{customer_id}/addresses","href":"/api-reference/customer-addresses/list-customer-addresses"},{"title":"Add customer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /customers/{customer_id}/addresses","href":"/api-reference/customer-addresses/add-customer-address"},{"title":"Get customer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /customers/{customer_id}/addresses/{id}","href":"/api-reference/customer-addresses/get-customer-address"},{"title":"Update customer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /customers/{customer_id}/addresses/{id}","href":"/api-reference/customer-addresses/update-customer-address"},{"title":"Delete customer address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /customers/{customer_id}/addresses/{id}","href":"/api-reference/customer-addresses/delete-customer-address"},{"title":"Set address as default billing","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /customers/{customer_id}/addresses/{id}/set_as_default_billing","href":"/api-reference/customer-addresses/set-address-as-default-billing"}]},{"group":"Payouts","pages":[{"title":"List payouts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /payouts","href":"/api-reference/payouts/list-payouts"},{"title":"Get payout details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /payouts/{uuid}","href":"/api-reference/payouts/get-payout-details"},{"title":"List pending payouts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /payouts/pending","href":"/api-reference/payouts/list-pending-payouts"}]},{"group":"Invoices","pages":[{"title":"List invoices","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Create invoice from order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /invoices","href":"/api-reference/invoices/create-invoice-from-order"},{"title":"Get invoice details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /invoices/{id}","href":"/api-reference/invoices/get-invoice-details"},{"title":"Update invoice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /invoices/{id}","href":"/api-reference/invoices/update-invoice"}]},{"group":"Transactions","pages":[{"title":"List transactions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Get transaction details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /transactions/{id}","href":"/api-reference/transactions/get-transaction-details"}]},{"group":"Products","pages":[{"title":"List products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /products","href":"/api-reference/products/list-products"},{"title":"Create product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /products","href":"/api-reference/products/create-product"},{"title":"Get product details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /products/{id}","href":"/api-reference/products/get-product-details"},{"title":"Archive product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /products/{id}","href":"/api-reference/products/archive-product"},{"title":"Update product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /products/{id}","href":"/api-reference/products/update-product"},{"title":"Bulk update products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /products/bulk_update","href":"/api-reference/products/bulk-update-products"},{"title":"Merge products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /products/merge","href":"/api-reference/products/merge-products"},{"title":"Product autocomplete","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /products/autocomplete","href":"/api-reference/products/product-autocomplete"},{"title":"Bulk import products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /products/import","href":"/api-reference/products/bulk-import-products"}]},{"group":"Deposit links","pages":[{"title":"List deposit links","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /deposit_links","href":"/api-reference/deposit-links/list-deposit-links"},{"title":"Create deposit link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /deposit_links","href":"/api-reference/deposit-links/create-deposit-link"},{"title":"Retrieve deposit link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /deposit_links/{uuid}","href":"/api-reference/deposit-links/retrieve-deposit-link"},{"title":"Cancel deposit link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /deposit_links/{uuid}","href":"/api-reference/deposit-links/cancel-deposit-link"},{"title":"Apply deposit to invoice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml put /deposit_links/{uuid}/invoice","href":"/api-reference/deposit-links/apply-deposit-to-invoice"},{"title":"Unqueue deposit from invoice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /deposit_links/{uuid}/invoice","href":"/api-reference/deposit-links/unqueue-deposit-from-invoice"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /webhook_endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /webhook_endpoints","href":"/api-reference/webhooks/create-webhook-endpoint"},{"title":"List webhook event types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /webhook_endpoints/event_types","href":"/api-reference/webhooks/list-webhook-event-types"},{"title":"Retrieve webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /webhook_endpoints/{uuid}","href":"/api-reference/webhooks/retrieve-webhook-endpoint"},{"title":"Delete webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /webhook_endpoints/{uuid}","href":"/api-reference/webhooks/delete-webhook-endpoint"},{"title":"Update webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /webhook_endpoints/{uuid}","href":"/api-reference/webhooks/update-webhook-endpoint"},{"title":"Rotate webhook secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /webhook_endpoints/{uuid}/rotate_secret","href":"/api-reference/webhooks/rotate-webhook-secret"},{"title":"Send test event","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /webhook_endpoints/{uuid}/test","href":"/api-reference/webhooks/send-test-event"},{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /webhook_endpoints/{uuid}/deliveries","href":"/api-reference/webhooks/list-webhook-deliveries"},{"title":"Retry webhook delivery","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /webhook_endpoints/{uuid}/deliveries/{delivery_uuid}/retry","href":"/api-reference/webhooks/retry-webhook-delivery"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Create customer - Streamlined","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-7TwLLapg.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}