Updates a customer’s profile and returns the updated CustomerDetail object. Change customer_group_id to move the customer to a different Customer Group, which drives group-specific pricing and promotions.
Names, email, phone, country code, group and tier IDs, status, and tag items, where supported, are trimmed of surrounding whitespace and reject blank or whitespace-only strings. When email, phone or country_code is supplied, the resulting stored contacts must retain at least one email or phone. Contact uniqueness is global across users and stores, including collisions with usernames.
first_name
string
Required string length: 1 - 255
last_name
string
Required string length: 1 - 255
email
string<email> | null
Customer email; null clears the email subject to the contact invariant.
Minimum string length: 1
phone
string | null
10 ASCII digits without country code; null clears the phone subject to the contact invariant.
Minimum string length: 1
Pattern: ^[0-9]{10}$
country_code
string
Country code, e.g. +91. If a nonempty phone changes and country_code is omitted, it is set to +91; otherwise an omitted country code is preserved.
Required string length: 1 - 5
Pattern: ^\+?\d{1,4}$
customer_group_id
string | null
Moves the customer to a different Customer Group. Null removes the customer from its group (rejected when the store has customer groups enabled). A non-null ID must belong to the store's configured groups.
Required string length: 1 - 255
business
object | null
Null or an empty object leaves business details unchanged. Null name or business_type clears that field; null registered_address leaves addresses unchanged.
Show child attributes
tags
string[]
Minimum string length: 1
attributes
CustomerAttributePayload · object[]
Attribute values to set on the customer. Each entry targets an existing store attribute by key (its ULID or slug); send null as the value to clear one. Omit the field to leave attributes unchanged. An empty array leaves existing attributes unchanged.
Show child attributes
metadata
object | null
The customer's own data as key-value pairs. Merged into what the customer has: each key sent is set, a key sent as null is removed, keys not sent are kept; null or {} changes nothing. At most 50 keys and 16 KB as JSON.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Commerce Engine Docs","description":"Official documentation for Commerce Engine - The modern headless commerce platform for building scalable e-commerce solutions.","colors":{"primary":"#00BF6F","light":"#00BF6F","dark":"#029558"},"logo":{"light":"https://mintcdn.com/tarkai/hIY7_H2biaAvOGu7/logo/CE_Developers_black.svg?fit=max\u0026auto=format\u0026n=hIY7_H2biaAvOGu7\u0026q=85\u0026s=d93f21564dfd373c7f2efc88c9d4301e","dark":"https://mintcdn.com/tarkai/hIY7_H2biaAvOGu7/logo/CE_Developers_white.svg?fit=max\u0026auto=format\u0026n=hIY7_H2biaAvOGu7\u0026q=85\u0026s=def973fb06c07f5eae14319cc3303339","href":"/"},"favicon":"https://mintcdn.com/tarkai/QX_fwpRYnT2rH-8q/favicon.png?fit=max\u0026auto=format\u0026n=QX_fwpRYnT2rH-8q\u0026q=85\u0026s=ebc190f98abe52e0e4220c74cea20fa6","api":{"openapi":{"source":"https://openapi.commercengine.io/ce-storefront.json","directory":"api-reference"},"playground":{"display":"interactive","proxy":false}},"appearance":{"default":"system"},"background":{"decoration":"windows","color":{"light":"#ffffff","dark":"#0d1816"}},"navbar":{"primary":{"type":"button","label":"Return to main site","href":"https://www.commercengine.io"}},"footer":{"socials":{"github":"https://github.com/tark-ai","twitter":"https://x.com/CommerceEngine","linkedin":"https://www.linkedin.com/company/commercengine"}},"search":{"prompt":"Search docs..."},"seo":{"metatags":{"canonical":"https://www.commercengine.io/docs","og:site_name":"Commerce Engine Developer Portal","og:locale":"en_US","og:logo":"/logo/CE_logo_whitebg.svg","twitter:site":"@CommerceEngine","og:image:width":"1200","og:image:height":"630","robots":"index, follow"},"indexing":"navigable"},"fonts":{"heading":{"family":"Satoshi","weight":700,"source":"https://images.tarkai.com/Commerce_Engine/Fonts/Satoshi-Variable.woff2","format":"woff2"},"body":{"family":"Satoshi","weight":450,"source":"https://images.tarkai.com/Commerce_Engine/Fonts/Satoshi-Variable.woff2","format":"woff2"}},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"integrations":{"ga4":{"measurementId":"G-6SVW3L2E90"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tarkai","hasAudioNarration":false,"actualSubdomain":"tarkai","customDomains":["www.commercengine.io"],"gitSource":{"type":"github","owner":"tark-ai","repo":"ce-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afda2d272aa9c06fc1d01a8","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":851},{"language":"default","tag":"Admin API","count":385},{"language":"default","tag":"Customers","count":252},{"language":"default","tag":"Webhooks","count":248},{"language":"default","tag":"Orders","count":168},{"language":"default","tag":"Catalog","count":149},{"language":"default","tag":"Store","count":146},{"language":"default","tag":"Storefront API","count":143},{"language":"default","tag":"Marketplace","count":90},{"language":"default","tag":"Payments","count":89}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa2JL7SUc.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa0ZL7SUc.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek-ext */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa2ZL7SUc.woff2) format('woff2');\n unicode-range: U+1F00-1FFF;\n}\n/* greek */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1pL7SUc.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa2pL7SUc.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa25L7SUc.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa2JL7SUc.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa0ZL7SUc.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek-ext */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa2ZL7SUc.woff2) format('woff2');\n unicode-range: U+1F00-1FFF;\n}\n/* greek */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1pL7SUc.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa2pL7SUc.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa25L7SUc.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa2JL7SUc.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa0ZL7SUc.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek-ext */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa2ZL7SUc.woff2) format('woff2');\n unicode-range: U+1F00-1FFF;\n}\n/* greek */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1pL7SUc.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa2pL7SUc.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa25L7SUc.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Inter';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/inter/v20/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n.font-medium{font-weight:525}#content-area.max-w-3xl{max-width:60rem!important}:root{--ce-white: #fff;--ce-black: #0e0e0f;--ce-green: #00bf6f;--ce-chart-green: #009354;--ce-goldenrod: #f6ffdb;--ce-bg-light-green: #e6faf2;--ce-shades-100: #f6f6f6;--ce-shades-300: #ececec;--ce-shades-800: #262626;--ce-shades-950: #e0dede;--ce-grid-line: #8f8f8f14;--ce-grid-fill: #3e3e3e06;--ce-skill-panel: #16191c;--ce-skill-inset: #101315;--ce-skill-border: #ffffff1a;--ce-skill-fg: #f3f5f6;--ce-skill-dim: #98a0a8;--ce-skill-mark: #2fd18c;--ce-code-block-bg: #1a1a1a;--ce-terminal-bg: #061636;--ce-terminal-body: #0c1f45;--ce-chrome-red: #ff5f56;--ce-chrome-amber: #ffbd2e;--ce-chrome-green: #27c93f;--ce-font-primary: \"Satoshi\", \"Satoshi Static\", system-ui, sans-serif;--ce-font-secondary: \"Inter\", system-ui, sans-serif;--ce-font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;--ce-text-2xs: 0.75rem;--ce-text-xs: 0.875rem;--ce-text-sm: 1rem;--ce-text-base: 1.125rem;--ce-text-xl: 1.375rem;--ce-text-4xl: 1.75rem;--ce-text-5xl: 2rem;--ce-text-7xl: 3.25rem;--ce-leading-sm: 1.15;--ce-leading-md: 1.3;--ce-leading-lg: 1.5;--ce-tracking-heading: -0.02em;--ce-tracking-eyebrow: 0.18em;--ce-tracking-label: 0.14em;--ce-container-lg: 67.5rem;--ce-container-xl: 75rem;--ce-container-2xl: 79.375rem;--ce-container-3xl: 90rem;--ce-header-shadow: #2416230a;--ce-radius-sm: 0.25rem;--ce-radius-md: 0.5rem;--ce-radius-lg: 0.75rem;--ce-radius-xl: 1rem;--ce-radius-2xl: 1.5rem;--ce-radius-full: 9999px;--ce-shadow-button: 0 2px 4px rgba(0, 0, 0, 0.1);--ce-shadow-tile-hover: 0 10px 24px rgba(0, 0, 0, 0.08);--ce-duration-hover: 300ms}[data-theme=\"dark\"],html.dark,body.dark{--ce-white: #0d1816;--ce-black: #fff;--ce-goldenrod: #002e27;--ce-bg-light-green: #03312e;--ce-shades-100: #142321;--ce-shades-300: #323232;--ce-shades-800: #e3e2e2;--ce-shades-950: #525252;--ce-chart-green: #00ad64;--ce-grid-line: #ffffff12;--ce-grid-fill: #ffffff08;--ce-header-shadow: #42424230}html[data-page-mode=\"custom\"] #navbar>div:nth-child(1),html[data-page-mode=\"custom\"] #navbar>div:nth-child(2){opacity:0;transition:opacity var(--ce-duration-hover) ease-out}html[data-page-mode=\"custom\"] #navbar>*:last-child{border:1px solid transparent;border-radius:var(--ce-radius-sm);background:transparent;box-shadow:0 0 0 0 transparent;margin-inline:auto;transition:all var(--ce-duration-hover) ease-out}html[data-page-mode=\"custom\"][data-scrolled=\"true\"] #navbar>*:last-child{width:calc(100% - 2rem);max-width:var(--ce-container-3xl);transform:translateY(12px);border-color:var(--ce-shades-300);background:var(--ce-white);box-shadow:4px 4px 4px 0 var(--ce-header-shadow)}@media (max-width: 992px){html[data-page-mode=\"custom\"][data-scrolled=\"true\"] #navbar>*:last-child{width:calc(100% - 1rem);transform:translateY(8px)}}@media (prefers-reduced-motion: reduce){html[data-page-mode=\"custom\"] #navbar>*:last-child,html[data-page-mode=\"custom\"] #navbar>div:nth-child(1),html[data-page-mode=\"custom\"] #navbar>div:nth-child(2){transition-duration:0.01ms}}.ce-home{background:var(--ce-white);color:var(--ce-black);font-family:var(--ce-font-primary)}.ce-home a{text-decoration:none}.ce-section{margin:0 auto;max-width:1100px;padding:72px 32px 0}.ce-section--last{padding-bottom:96px}.ce-section--wide{max-width:var(--ce-container-2xl)}.ce-page-title{margin:0;font-size:var(--ce-text-7xl);font-weight:700;line-height:var(--ce-leading-sm);letter-spacing:var(--ce-tracking-heading)}.ce-page-lede{margin:16px 0 0;max-width:46rem;font-size:var(--ce-text-base);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}@media (max-width: 992px){.ce-page-title{font-size:2.5rem}}.ce-h2{margin:0;font-size:var(--ce-text-5xl);font-weight:700;line-height:var(--ce-leading-md);letter-spacing:var(--ce-tracking-heading)}.ce-home table{width:100%;margin:20px 0 0;border-collapse:collapse;font-size:var(--ce-text-xs);line-height:var(--ce-leading-lg)}.ce-home thead th{border-bottom:1px solid var(--ce-shades-300);padding:10px 14px;text-align:left;font-weight:700;color:var(--ce-black)}.ce-home tbody td{border-bottom:1px solid var(--ce-shades-300);padding:10px 14px;color:var(--ce-shades-800);vertical-align:top}.ce-home tbody tr:hover{background:var(--ce-shades-100)}.ce-home table a{color:var(--ce-black);font-weight:500;text-decoration:underline;text-decoration-color:var(--ce-shades-300);text-underline-offset:3px}.ce-home table a:hover{color:var(--ce-green);text-decoration-color:var(--ce-green)}.ce-home table code,.ce-home p code,.ce-home li code{border-radius:var(--ce-radius-sm);background:var(--ce-shades-100);padding:2px 6px;font-family:var(--ce-font-mono);font-size:0.9em}.ce-home .ce-cmd code,.ce-home .ce-term-pre code,.ce-home .ce-agent-prompt code,.ce-home .ce-frame-url code{background:none;padding:0;border-radius:0;font-size:inherit}.ce-home .ce-section>*+*{margin-top:20px}.ce-home .ce-section>.ce-h2{margin-top:56px}.ce-home .ce-section>.ce-h2:first-child{margin-top:0}.ce-lede{margin:12px 0 0;font-size:var(--ce-text-sm);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-hero{position:relative;overflow:hidden;border-bottom:1px solid var(--ce-shades-300)}.ce-hero-inner{position:relative;z-index:10;margin:0 auto;max-width:1100px;padding:80px 32px 72px;display:grid;grid-template-columns:1.05fr 0.95fr;gap:56px;align-items:center}.ce-hero-copy{display:grid;gap:24px;justify-items:start}.ce-hero-title{margin:0;font-size:var(--ce-text-7xl);font-weight:700;line-height:var(--ce-leading-sm);letter-spacing:var(--ce-tracking-heading)}.ce-hero-title em{font-style:normal;color:var(--ce-green)}.ce-hero-body{margin:0;max-width:34rem;font-size:var(--ce-text-base);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-hero-actions{display:flex;gap:16px;flex-wrap:wrap}.ce-hero-media{display:grid;gap:16px}.ce-hero-grid{position:absolute;inset:0;z-index:0;background-color:var(--ce-goldenrod);background-image:repeating-linear-gradient(to right, var(--ce-grid-line) 0 1px, transparent 1px 102px),\n repeating-linear-gradient(to bottom, var(--ce-grid-line) 0 1px, transparent 1px 102px)}.ce-hero-grid::before,.ce-hero-grid::after{content:\"\";position:absolute;width:102px;height:102px;background:var(--ce-grid-fill)}.ce-hero-grid::before{left:0;top:0}.ce-hero-grid::after{left:816px;top:102px}.ce-eyebrow{display:inline-flex;align-items:center;gap:8px;margin:0;border-radius:var(--ce-radius-full);border:1px solid var(--ce-shades-300);background:var(--ce-white);padding:6px 12px;font-family:var(--ce-font-secondary);font-size:var(--ce-text-2xs);font-weight:500;text-transform:uppercase;letter-spacing:var(--ce-tracking-eyebrow);color:var(--ce-shades-800)}.ce-eyebrow::before{content:\"\";width:6px;height:6px;flex-shrink:0;border-radius:var(--ce-radius-full);background:var(--ce-green)}.ce-eyebrow--dark{border:0;background:none;padding:0;color:var(--ce-skill-dim);letter-spacing:var(--ce-tracking-eyebrow)}.ce-eyebrow--dark::before{background:var(--ce-skill-mark)}.ce-btn{position:relative;overflow:hidden;display:inline-flex;align-items:center;justify-content:center;gap:10px;border:0;border-radius:var(--ce-radius-full);padding:10px 20px;font-family:var(--ce-font-secondary);font-size:var(--ce-text-sm);line-height:var(--ce-leading-lg);font-weight:500;white-space:nowrap;box-shadow:var(--ce-shadow-button);transition:all var(--ce-duration-hover);cursor:pointer}.ce-btn:hover{transform:translateY(-3px) scale(1.02)}.ce-btn:active{transform:translateY(0) scale(1);transition-duration:75ms}.ce-btn:focus-visible{outline:2px solid var(--ce-black);outline-offset:2px}.ce-btn--primary{background:var(--ce-green);color:#fff}.ce-btn--primary:hover{box-shadow:0 6px 15px rgba(0, 0, 0, 0.15),\n 0 10px 30px -8px color-mix(in srgb, var(--ce-green) 60%, transparent)}.ce-btn--secondary{border:1px solid var(--ce-shades-950);background:var(--ce-white);color:var(--ce-black)}.ce-btn--secondary:hover{border-color:var(--ce-shades-800);box-shadow:0 6px 15px rgba(0, 0, 0, 0.12)}.ce-cards{margin-top:32px;display:grid;grid-template-columns:repeat(3, 1fr);gap:20px}.ce-card{display:grid;gap:10px;align-content:start;border:1px solid var(--ce-shades-300);border-radius:var(--ce-radius-xl);background:var(--ce-white);padding:24px;color:var(--ce-black);transition:transform var(--ce-duration-hover),\n box-shadow var(--ce-duration-hover),\n border-color var(--ce-duration-hover)}.ce-card:hover{transform:translateY(-4px);box-shadow:var(--ce-shadow-tile-hover);border-color:var(--ce-green)}.ce-card-step{font-family:var(--ce-font-mono);font-size:var(--ce-text-2xs);color:var(--ce-chart-green)}.ce-card h3{margin:0;font-size:var(--ce-text-xl);font-weight:700;line-height:var(--ce-leading-md)}.ce-card p{margin:0;font-size:var(--ce-text-sm);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-skills{overflow:hidden;border-radius:var(--ce-radius-2xl);background:var(--ce-skill-panel);color:var(--ce-skill-fg);display:grid;grid-template-columns:1fr 1fr;gap:48px;padding:40px}.ce-skills-copy{display:grid;gap:20px;align-content:start}.ce-skills-copy h2{margin:0;font-size:var(--ce-text-5xl);font-weight:700;line-height:var(--ce-leading-md);letter-spacing:var(--ce-tracking-heading);color:var(--ce-skill-fg)}.ce-skills-copy p.ce-skills-body{margin:0;font-size:var(--ce-text-sm);line-height:var(--ce-leading-lg);color:var(--ce-skill-dim)}.ce-agents{display:flex;align-items:center;gap:12px}.ce-agent{display:flex;width:40px;height:40px;align-items:center;justify-content:center;border-radius:var(--ce-radius-lg);background:#fff}.ce-agent img{width:22px;height:22px;object-fit:contain}.ce-skills-links{display:flex;gap:24px;flex-wrap:wrap;padding-top:4px}.ce-skills-links a{font-size:var(--ce-text-sm);color:var(--ce-skill-mark)}.ce-skills-links a:hover{text-decoration:underline}.ce-skills-demo{display:grid;align-content:center}.ce-skills-demo pre{margin:0;border-radius:var(--ce-radius-lg);background:var(--ce-skill-inset);border:1px solid var(--ce-skill-border);padding:16px 18px;font-family:var(--ce-font-mono);font-size:12px;line-height:1.9;color:var(--ce-skill-fg);white-space:pre-wrap;overflow-x:auto}.ce-skills-demo .ce-dim{color:var(--ce-skill-dim)}.ce-skills-demo .ce-mark{color:var(--ce-skill-mark)}.ce-guides{margin-top:28px;display:grid;grid-template-columns:1fr 1fr;gap:0 40px}.ce-guide{display:grid;grid-template-columns:1fr auto;align-items:center;gap:16px;border-top:1px solid var(--ce-shades-300);padding:20px 16px;color:var(--ce-black);transition:background var(--ce-duration-hover)}.ce-guide:hover{background:var(--ce-shades-100)}.ce-guide-title{display:block;font-size:var(--ce-text-base);font-weight:700}.ce-guide-sub{display:block;margin-top:4px;font-size:var(--ce-text-xs);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-guide-arrow{color:var(--ce-green)}.ce-starters{border-radius:var(--ce-radius-2xl);border:1px solid var(--ce-shades-300);background:var(--ce-shades-100);padding:32px}.ce-starters-head{display:grid;grid-template-columns:1fr auto;gap:32px;align-items:center}.ce-starters-head h2{margin:0;font-size:var(--ce-text-4xl);font-weight:700;line-height:var(--ce-leading-md);letter-spacing:var(--ce-tracking-heading)}.ce-starters-head p{margin:10px 0 0;max-width:38rem;font-size:var(--ce-text-sm);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-chips{margin-top:24px;display:grid;grid-template-columns:repeat(6, 1fr);gap:12px}.ce-chip{display:flex;align-items:center;gap:10px;border:1px solid var(--ce-shades-300);border-radius:var(--ce-radius-lg);background:var(--ce-white);padding:12px;color:var(--ce-black);font-size:var(--ce-text-xs);font-weight:500;transition:transform var(--ce-duration-hover),\n border-color var(--ce-duration-hover)}.ce-chip:hover{transform:translateY(-2px);border-color:var(--ce-green)}.ce-chip-mark{display:flex;width:32px;height:32px;flex-shrink:0;align-items:center;justify-content:center;border-radius:var(--ce-radius-md);background:#fff;box-shadow:0 0 0 1px rgba(0, 0, 0, 0.05)}.ce-chip-mark img{width:18px;height:18px;object-fit:contain}.ce-trio{display:grid;grid-template-columns:repeat(3, 1fr);gap:20px}.ce-trio-item{border-top:2px solid var(--ce-shades-300);padding-top:16px;color:var(--ce-black)}.ce-trio-item--active{border-top-color:var(--ce-green)}a.ce-trio-item{transition:border-color var(--ce-duration-hover),\n transform var(--ce-duration-hover)}a.ce-trio-item:hover{border-top-color:var(--ce-green);transform:translateY(-2px)}a.ce-trio-item:hover h3{color:var(--ce-green)}a.ce-trio-item:focus-visible{outline:2px solid var(--ce-black);outline-offset:4px}.ce-trio-item h3{margin:0;font-size:var(--ce-text-base);font-weight:700}.ce-trio-item p{margin:6px 0 0;font-size:var(--ce-text-xs);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-cmd{overflow:hidden;border-radius:var(--ce-radius-lg);background:var(--ce-code-block-bg)}.ce-cmd-label{margin:0;border-bottom:1px solid rgba(255, 255, 255, 0.1);padding:10px 16px;font-family:var(--ce-font-secondary);font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:var(--ce-tracking-label);color:rgba(255, 255, 255, 0.75)}.ce-cmd ul{list-style:none;margin:0;padding:0}.ce-cmd li{display:flex;align-items:center;gap:12px;padding:10px 16px;border-top:1px solid rgba(255, 255, 255, 0.05)}.ce-cmd li:first-child{border-top:0}.ce-cmd code{min-width:0;flex:1;overflow-x:auto;white-space:pre;font-family:var(--ce-font-mono);font-size:11px;line-height:var(--ce-leading-lg);color:#fff;background:none;border:0;padding:0;scrollbar-width:none}.ce-cmd code::-webkit-scrollbar{display:none}.ce-cmd code[data-wrap=\"true\"]{white-space:pre-wrap;overflow-x:visible}.ce-cmd-prefix{user-select:none;color:var(--ce-green)}.ce-cmd-copy{display:flex;width:28px;height:28px;flex-shrink:0;cursor:pointer;align-items:center;justify-content:center;border:0;border-radius:var(--ce-radius-md);background:none;color:rgba(255, 255, 255, 0.5);font-size:12px;transition:color 0.2s,\n background 0.2s}.ce-cmd-copy:hover{background:rgba(255, 255, 255, 0.1);color:#fff}.ce-cmd-copy[data-copied=\"true\"]{color:var(--ce-green)}div:has(>[role=\"menu\"] a[href$=\"/sdk/installation\"]),div:has(>[role=\"menu\"] a[href$=\"/storefront/quickstart\"]){position:fixed!important;top:calc(var(--banner-height, 0px) + 52px)!important;left:50%!important;transform:translateX(-50%)!important}[role=\"menu\"]:has(.nav-dropdown-item){width:fit-content!important;max-width:calc(100vw - 64px)!important;max-height:none!important;display:grid!important;grid-auto-flow:column;grid-auto-columns:minmax(220px, 300px);align-content:start;gap:6px 24px;padding:24px!important;border-radius:var(--ce-radius-2xl)!important;box-shadow:0 12px 36px rgba(0, 0, 0, 0.09)!important}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]),[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]){width:1000px!important;grid-auto-flow:row;grid-template-columns:repeat(3, minmax(0, 1fr));gap:6px 32px;padding:32px!important}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(1){grid-area:1 / 1}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(2){grid-area:2 / 1}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(3){grid-area:1 / 2}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(4){grid-area:2 / 2}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(5){grid-area:1 / 3}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(6){grid-area:2 / 3}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(7){grid-area:3 / 3}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(1){grid-area:1 / 1}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(2){grid-area:2 / 1}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(3){grid-area:3 / 1}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(4){grid-area:1 / 2}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(5){grid-area:2 / 2}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(6){grid-area:1 / 3}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(7){grid-area:2 / 3}.nav-dropdown-item{display:grid!important;grid-template-columns:auto minmax(0, 1fr);gap:12px;align-items:start!important;border-radius:var(--ce-radius-md)!important;padding:10px 12px!important;color:var(--ce-black)!important;transition:background var(--ce-duration-hover)}.nav-dropdown-item:hover{background:var(--ce-shades-100)!important}.nav-dropdown-item>svg{width:18px;height:18px;margin-top:2px;color:var(--ce-chart-green)}.nav-dropdown-item>div>span:first-child{font-family:var(--ce-font-mono);font-size:var(--ce-text-sm);font-weight:500;color:var(--ce-black)}.nav-dropdown-item>div>span:last-child{margin-top:3px;font-size:var(--ce-text-xs);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)!important}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(1),[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(3),[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(5),[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(1),[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(4),[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(6){position:relative;margin-top:26px}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(1)::before{content:\"Storefront\"}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(3)::before{content:\"Checkout \u0026 POS\"}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(5)::before{content:\"Growth \u0026 AI\"}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(1)::before{content:\"Get started\"}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(4)::before{content:\"Build\"}[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(6)::before{content:\"SEO \u0026 AI\"}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(1)::before,[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(3)::before,[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(5)::before,[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(1)::before,[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(4)::before,[role=\"menu\"]:has(a[href$=\"/storefront/quickstart\"]) .nav-dropdown-item:nth-child(6)::before{position:absolute;top:-22px;left:12px;font-family:var(--ce-font-secondary);font-size:var(--ce-text-2xs);font-weight:500;text-transform:uppercase;letter-spacing:var(--ce-tracking-eyebrow);color:var(--ce-shades-600)}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(8){grid-area:4 / 1 / auto / -1;margin-top:20px;border-top:1px solid var(--ce-shades-300);padding-top:20px!important;grid-template-columns:repeat(3, auto);justify-content:center;align-items:center!important;gap:10px}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(8)>svg{margin-top:0}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(8)>div{display:block}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(8)>div>span:first-child{font-family:var(--ce-font-secondary);font-size:var(--ce-text-xs);text-transform:uppercase;letter-spacing:var(--ce-tracking-eyebrow)}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(8)>div>span:last-child{display:none}[role=\"menu\"]:has(a[href$=\"/sdk/installation\"]) .nav-dropdown-item:nth-child(8):hover>div>span:first-child{color:var(--ce-green)}@media (max-width: 1100px){[role=\"menu\"]:has(.nav-dropdown-item){width:auto!important;grid-template-columns:1fr}.nav-dropdown-item:nth-child(n){grid-area:auto!important}}.ce-portal{margin:20px 0;border:1px solid var(--ce-shades-300);border-radius:var(--ce-radius-xl);background:var(--ce-shades-100);padding:20px}.ce-portal-label{display:block;margin-bottom:10px;font-family:var(--ce-font-secondary);font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:var(--ce-tracking-label);color:var(--ce-shades-800)}.ce-portal-row{display:flex;flex-wrap:wrap;align-items:center;gap:12px}.ce-portal-field{display:flex;min-width:0;flex:1 1 320px;align-items:center;overflow:hidden;border:1px solid var(--ce-shades-300);border-radius:var(--ce-radius-full);background:var(--ce-white);transition:border-color var(--ce-duration-hover)}.ce-portal-field:focus-within{border-color:var(--ce-green)}.ce-portal-field input{min-width:0;flex:1;border:0;background:none;padding:11px 16px;font-family:var(--ce-font-mono);font-size:var(--ce-text-xs);color:var(--ce-black);outline:none}.ce-portal-field select{flex-shrink:0;border:0;border-left:1px solid var(--ce-shades-300);background:none;padding:11px 14px;font-family:var(--ce-font-mono);font-size:var(--ce-text-xs);color:var(--ce-shades-800);cursor:pointer;outline:none}.ce-portal .ce-btn[data-disabled=\"true\"]{pointer-events:none;opacity:0.45}.ce-portal-url{margin:12px 0 0;font-size:var(--ce-text-2xs);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-portal-url code{font-family:var(--ce-font-mono);word-break:break-all}@media (max-width: 550px){.ce-portal-row{flex-direction:column;align-items:stretch}}.ce-footer{margin-top:96px;border-top:1px solid var(--ce-shades-300);background:var(--ce-shades-100)}.ce-footer-inner{margin:0 auto;max-width:var(--ce-container-2xl);padding:56px 32px 40px;display:grid;grid-template-columns:minmax(0, 1fr) minmax(0, 2.2fr);gap:48px}.ce-footer-brand img{height:28px;width:auto}.ce-footer-logo-dark{display:none}[data-theme=\"dark\"] .ce-footer-logo-light,html.dark .ce-footer-logo-light{display:none}[data-theme=\"dark\"] .ce-footer-logo-dark,html.dark .ce-footer-logo-dark{display:block}.ce-footer-brand p{margin:14px 0 0;max-width:22rem;font-size:var(--ce-text-xs);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-footer-socials{margin-top:20px;display:flex;gap:10px}.ce-footer-socials a{display:flex;width:34px;height:34px;align-items:center;justify-content:center;border-radius:var(--ce-radius-full);border:1px solid var(--ce-shades-300);background:var(--ce-white);color:var(--ce-shades-800);transition:color var(--ce-duration-hover),\n border-color var(--ce-duration-hover),\n transform var(--ce-duration-hover)}.ce-footer-socials a:hover{color:var(--ce-green);border-color:var(--ce-green);transform:translateY(-2px)}.ce-footer-cols{display:grid;grid-template-columns:repeat(4, minmax(0, 1fr));gap:32px}.ce-footer-heading{margin:0 0 12px;font-family:var(--ce-font-secondary);font-size:var(--ce-text-2xs);font-weight:500;text-transform:uppercase;letter-spacing:var(--ce-tracking-eyebrow);color:var(--ce-shades-600, #6e6e6f)}.ce-footer-col ul{margin:0;padding:0;list-style:none;display:grid;gap:9px}.ce-footer-col li{margin:0}.ce-footer-col a{font-size:var(--ce-text-xs);line-height:var(--ce-leading-lg);color:var(--ce-shades-800);transition:color var(--ce-duration-hover)}.ce-footer-col a:hover{color:var(--ce-green)}.ce-footer-bar{border-top:1px solid var(--ce-shades-300)}.ce-footer-bar{margin:0 auto;max-width:var(--ce-container-2xl);padding:20px 32px 32px;display:flex;flex-wrap:wrap;justify-content:space-between;gap:12px;font-size:var(--ce-text-2xs);color:var(--ce-shades-600, #6e6e6f)}@media (max-width: 992px){.ce-footer-inner{grid-template-columns:1fr;gap:36px;padding:40px 24px 32px}.ce-footer-cols{grid-template-columns:repeat(2, minmax(0, 1fr))}.ce-footer-bar{padding:20px 24px 28px}}.ce-starters{display:grid;gap:24px;margin:28px 0}.ce-starter-card{display:grid;grid-template-columns:1.4fr 1fr;overflow:hidden;border:1px solid var(--ce-shades-300);border-radius:var(--ce-radius-2xl);background:var(--ce-white);transition:all var(--ce-duration-hover)}.ce-starter-card:hover{transform:translateY(-4px);border-color:var(--ce-green);box-shadow:0 18px 44px rgba(0, 0, 0, 0.12)}.ce-starter-preview{display:flex;min-width:0;align-items:center;background:var(--ce-shades-100);padding:24px}.ce-frame{width:100%;overflow:hidden;border:1px solid var(--ce-shades-300);border-radius:var(--ce-radius-xl);background:var(--ce-white);box-shadow:0 10px 30px rgba(0, 0, 0, 0.1);transition:transform 500ms var(--ce-ease-out, ease-out)}.ce-starter-card:hover .ce-frame{transform:scale(1.02)}.ce-frame-bar{display:flex;align-items:center;gap:8px;border-bottom:1px solid var(--ce-shades-300);background:var(--ce-shades-100);padding:10px 12px}.ce-frame-bar span:not(.ce-frame-url){width:10px;height:10px;flex-shrink:0;border-radius:var(--ce-radius-full)}.ce-frame-url{margin-left:8px;min-width:0;flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;border-radius:var(--ce-radius-full);background:var(--ce-white);padding:4px 12px;font-size:var(--ce-text-2xs);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-frame-viewport{position:relative;overflow:hidden;aspect-ratio:16 / 10}.ce-frame-viewport img{width:100%;height:100%;object-fit:cover;object-position:top center;display:block}.ce-starter-body{display:flex;min-width:0;flex-direction:column;padding:28px}.ce-starter-category{align-self:start;border-radius:var(--ce-radius-full);border:1px solid var(--ce-shades-300);background:var(--ce-shades-100);padding:4px 10px;font-family:var(--ce-font-secondary);font-size:var(--ce-text-2xs);font-weight:500;color:var(--ce-shades-800)}.ce-starter-name{margin:12px 0 0;font-size:var(--ce-text-5xl);font-weight:700;line-height:var(--ce-leading-md);letter-spacing:var(--ce-tracking-heading);color:var(--ce-black)}.ce-starter-desc{margin:10px 0 0;font-size:var(--ce-text-sm);line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-starter-features{margin:20px 0 0;padding:0;list-style:none;display:flex;flex-wrap:wrap;gap:6px}.ce-starter-features li{margin:0;border-radius:var(--ce-radius-md);border:1px solid var(--ce-shades-300);background:var(--ce-shades-100);padding:4px 8px;font-family:var(--ce-font-secondary);font-size:11px;line-height:var(--ce-leading-lg);color:var(--ce-shades-800)}.ce-starter-foot{margin-top:auto;padding-top:24px}.ce-fw{min-width:0;margin:0;padding:0;border:0}.ce-fw legend{margin-bottom:10px;padding:0;font-family:var(--ce-font-secondary);font-size:11px;font-weight:500;text-transform:uppercase;letter-spacing:0.12em;color:var(--ce-shades-800)}.ce-fw-grid{display:grid;grid-template-columns:repeat(3, minmax(0, 1fr));gap:6px}.ce-fw-option{display:flex;min-height:40px;cursor:pointer;align-items:center;gap:6px;border-radius:var(--ce-radius-lg);border:1px solid var(--ce-shades-300);background:var(--ce-white);padding:0 8px;color:var(--ce-shades-800);transition:border-color 200ms, background 200ms}.ce-fw-option:hover{border-color:var(--ce-green)}.ce-fw-option[data-active=\"true\"]{border-color:var(--ce-green);background:var(--ce-bg-light-green);color:var(--ce-black)}.ce-fw-option:has(input:focus-visible){outline:2px solid var(--ce-green);outline-offset:2px}.ce-fw-option input{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;border:0}.ce-fw-mark{display:flex;width:18px;height:18px;flex-shrink:0;align-items:center;justify-content:center;border-radius:var(--ce-radius-full);background:#fff;box-shadow:0 0 0 1px rgba(0, 0, 0, 0.05)}.ce-fw-mark img{width:12px;height:12px;object-fit:contain}.ce-fw-name{min-width:0;flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-family:var(--ce-font-secondary);font-size:11px;font-weight:500}.ce-fw-option svg{flex-shrink:0;color:var(--ce-green)}.ce-fw-spacer{width:12px;flex-shrink:0}.ce-starter-hero-cmd{margin:28px 0 0;display:flex;flex-wrap:wrap;align-items:baseline;gap:8px 14px;border:1px solid var(--ce-shades-300);border-radius:var(--ce-radius-xl);background:var(--ce-shades-100);padding:18px 20px}.ce-starter-hero-label{font-family:var(--ce-font-secondary);font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:var(--ce-tracking-label);color:var(--ce-shades-800)}.ce-starter-hero-cmd code{border-radius:var(--ce-radius-md);background:var(--ce-code-block-bg);padding:8px 14px;font-family:var(--ce-font-mono);font-size:var(--ce-text-xs);color:#fff}.ce-starter-hero-note{font-size:var(--ce-text-2xs);color:var(--ce-shades-800)}.ce-starter-cmd{margin-top:18px;display:flex;align-items:center;gap:8px;overflow:hidden;border-radius:var(--ce-radius-md);background:var(--ce-code-block-bg);padding:8px 8px 8px 12px}.ce-starter-cmd code{min-width:0;flex:1;overflow-x:auto;white-space:pre;border:0;background:none;padding:0;font-family:var(--ce-font-mono);font-size:11px;line-height:var(--ce-leading-lg);color:#fff;scrollbar-width:none}.ce-starter-cmd code::-webkit-scrollbar{display:none}.ce-starter-actions{margin-top:16px;display:flex;flex-wrap:wrap;align-items:center;gap:12px}@media (max-width: 992px){.ce-starter-card{grid-template-columns:1fr}.ce-starter-preview{padding:16px}.ce-starter-body{padding:20px}.ce-starter-name{font-size:var(--ce-text-4xl)}}@media (max-width: 550px){.ce-fw-grid{grid-template-columns:repeat(2, minmax(0, 1fr))}.ce-starter-actions{flex-direction:column;align-items:stretch}}.ce-agent-setup{display:grid;gap:0}.ce-agent-step{margin:0;font-family:var(--ce-font-secondary);font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:var(--ce-tracking-label);color:var(--ce-shades-800)}.ce-agent-choices{margin-top:12px;display:flex;flex-wrap:wrap;gap:7px}.ce-agent-choice{display:flex;min-height:44px;cursor:pointer;align-items:center;gap:8px;border-radius:var(--ce-radius-full);border:1px solid var(--ce-shades-300);background:var(--ce-white);padding:8px 12px;color:var(--ce-black);font-family:var(--ce-font-secondary);font-size:var(--ce-text-xs);font-weight:500;line-height:var(--ce-leading-lg);transition:all 200ms}.ce-agent-choice:hover{border-color:var(--ce-green)}.ce-agent-choice[data-active=\"true\"]{border-color:var(--ce-green);background:var(--ce-bg-light-green)}.ce-agent-choice:focus-visible{outline:2px solid var(--ce-green);outline-offset:2px}.ce-agent-choice-mark{display:flex;width:18px;height:18px;flex-shrink:0;align-items:center;justify-content:center;border-radius:var(--ce-radius-full);background:#fff;box-shadow:0 0 0 1px rgba(0, 0, 0, 0.05)}.ce-agent-choice-mark img{width:12px;height:12px;object-fit:contain}.ce-agent-block{margin-top:20px}.ce-agent-prompt{display:flex;align-items:flex-start;gap:12px;padding:12px 16px}.ce-agent-prompt p{min-width:0;flex:1;margin:0;font-family:var(--ce-font-mono);font-size:11px;line-height:1.7;color:rgba(255, 255, 255, 0.9)}.ce-term{display:flex;min-height:280px;width:100%;flex-direction:column;overflow:hidden;border-radius:var(--ce-radius-lg);border:1px solid rgba(255, 255, 255, 0.1);background:var(--ce-terminal-bg)}.ce-term-bar{display:flex;gap:8px;border-bottom:1px solid rgba(255, 255, 255, 0.1);padding:16px}.ce-term-bar span{width:12px;height:12px;border-radius:var(--ce-radius-full)}.ce-term-dot-red{background:var(--ce-chrome-red)}.ce-term-dot-amber{background:var(--ce-chrome-amber)}.ce-term-dot-green{background:var(--ce-chrome-green)}.ce-term-pre{flex:1;overflow-x:auto;margin:0;background:var(--ce-terminal-body);padding:16px;font-family:var(--ce-font-mono);font-size:var(--ce-text-sm);line-height:1.5;color:#fff;scrollbar-width:none}.ce-term-pre::-webkit-scrollbar{display:none}.ce-term-pre code{white-space:pre;background:none;border:0;padding:0;color:inherit}.ce-term-cursor{animation:ce-blink 1s step-end infinite;color:var(--ce-chrome-green)}@keyframes ce-blink{0%,50%{opacity:1}51%,100%{opacity:0}}@media (max-width: 1200px){.ce-hero-title{font-size:2.5rem}}@media (max-width: 992px){.ce-hero-inner,.ce-skills{grid-template-columns:1fr}.ce-hero-inner{gap:40px;padding:56px 24px 56px}.ce-skills{gap:32px;padding:32px 24px}.ce-section{padding:56px 24px 0}.ce-cards,.ce-trio{grid-template-columns:1fr}.ce-guides{grid-template-columns:1fr;gap:0}.ce-chips{grid-template-columns:repeat(3, 1fr)}.ce-starters-head{grid-template-columns:1fr;gap:20px}}@media (max-width: 550px){.ce-hero-title{font-size:2rem}.ce-h2,.ce-skills-copy h2{font-size:1.625rem}.ce-chips{grid-template-columns:repeat(2, 1fr)}}@media (prefers-reduced-motion: reduce){.ce-home *,.ce-home *::before,.ce-home *::after{animation-duration:0.01ms!important;animation-iteration-count:1!important;transition-duration:0.01ms!important}}"}]}
{"page":{"pagePath":"api-reference/pos/customers/update-customer","slug":"/api-reference/pos/customers/update-customer","pageMetadata":{"title":"Update customer","description":"Updates a customer's profile and returns the updated `CustomerDetail` object. Change `customer_group_id` to move the customer to a different Customer Group, which drives group-specific pricing and promotions.","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json put /pos/customers/{id}","href":"/api-reference/pos/customers/update-customer","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Updates a customer’s profile and returns the updated \", _jsx(_components.code, {\n children: \"CustomerDetail\"\n }), \" object. Change \", _jsx(_components.code, {\n children: \"customer_group_id\"\n }), \" to move the customer to a different Customer Group, which drives group-specific pricing and promotions.\"]\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":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Update customer","description":"Updates a customer's profile and returns the updated `CustomerDetail` object. Change `customer_group_id` to move the customer to a different Customer Group, which drives group-specific pricing and promotions.","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json put /pos/customers/{id}","href":"/api-reference/pos/customers/update-customer","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/tarkai/83faf160ccb5c4ff/header-float.js"],"openApiReferenceData":{"operation":{"tags":["Customers"],"operationId":"pos-update-customer","summary":"Update customer","description":"Updates a customer's profile and returns the updated `CustomerDetail` object. Change `customer_group_id` to move the customer to a different Customer Group, which drives group-specific pricing and promotions.","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/operations/pos-update-customer"},"parameters":["b70c93cc-22d6-42c6-b68d-4452643cf0af"],"requestBody":"f686bd97-d5b7-4abd-be0b-fcb87e30698a","responses":{"200":"cba8298e-7197-4590-8fcc-3c4fc6cc38c3","400":"99b2d815-12a5-4f8a-868a-e60f578023e8","401":"005f8502-6da6-41bd-9482-e68a4e2a48cc","403":"c9437079-d040-4956-a5cd-dc72c7b160e2","404":"4e958157-826f-494d-b5e1-4807731c4226","500":"94b352cf-9854-47a3-9847-fb4c99c8e75a","504":"487e3883-99f2-4310-bf3e-4fe5660ab755"},"security":["423393ac-717c-4334-9571-10ca10e70bf6"],"x-speakeasy-group":"pos","method":"put","type":"path","servers":["d5140fa8-2bd5-4c13-abb4-72a9479f9f58","503d314f-8bfe-43e5-9c58-f8d1033bbbb9"],"path":"/pos/customers/{id}","baseUrlOptions":["https://staging.api.commercengine.io/api/v1/{store_id}/storefront","https://prod.api.commercengine.io/api/v1/{store_id}/storefront"],"title":"Update customer","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"b70c93cc-22d6-42c6-b68d-4452643cf0af":{"name":"id","in":"path","description":"Customer Id","required":true,"schema":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]{1,128}$","isRequired":true,"description":"Customer Id","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"title":"UpdateCustomer","description":"Names, email, phone, country code, group and tier IDs, status, and tag items, where supported, are trimmed of surrounding whitespace and reject blank or whitespace-only strings. When email, phone or country_code is supplied, the resulting stored contacts must retain at least one email or phone. Contact uniqueness is global across users and stores, including collisions with usernames.","type":"object","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/UpdateCustomer"},"properties":{"first_name":{"type":"string","maxLength":255,"minLength":1,"uniqueKey":"first_name","typeLabel":"string"},"last_name":{"type":"string","maxLength":255,"minLength":1,"uniqueKey":"last_name","typeLabel":"string"},"email":{"oneOf":[{"description":"Customer email; null clears the email subject to the contact invariant.","type":"string","format":"email","minLength":1,"uniqueKey":"email.oneOf.0","typeLabel":"string\u003cemail>"},{"description":"Customer email; null clears the email subject to the contact invariant.","type":"null","format":"email","minLength":1,"uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string\u003cemail> | null"},"phone":{"oneOf":[{"type":"string","description":"10 ASCII digits without country code; null clears the phone subject to the contact invariant.","minLength":1,"pattern":"^[0-9]{10}$","uniqueKey":"phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"10 ASCII digits without country code; null clears the phone subject to the contact invariant.","uniqueKey":"phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"phone","typeLabel":"string | null"},"country_code":{"description":"Country code, e.g. +91. If a nonempty phone changes and country_code is omitted, it is set to +91; otherwise an omitted country code is preserved.","type":"string","maxLength":5,"minLength":1,"pattern":"^\\+?\\d{1,4}$","uniqueKey":"country_code","typeLabel":"string"},"customer_group_id":{"oneOf":[{"description":"Moves the customer to a different Customer Group. Null removes the customer from its group (rejected when the store has customer groups enabled). A non-null ID must belong to the store's configured groups.","type":"string","maxLength":255,"minLength":1,"uniqueKey":"customer_group_id.oneOf.0","typeLabel":"string"},{"description":"Moves the customer to a different Customer Group. Null removes the customer from its group (rejected when the store has customer groups enabled). A non-null ID must belong to the store's configured groups.","type":"null","maxLength":255,"minLength":1,"uniqueKey":"customer_group_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"customer_group_id","typeLabel":"string | null"},"business":{"oneOf":[{"description":"Null or an empty object leaves business details unchanged. Null name or business_type clears that field; null registered_address leaves addresses unchanged.","type":"object","properties":{"name":{"oneOf":[{"type":"string","maxLength":255,"minLength":1,"uniqueKey":"business.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"minLength":1,"uniqueKey":"business.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"business.oneOf.0.name","typeLabel":"string | null"},"registered_address":{"oneOf":[{"type":"object","title":"UpdateCustomerRegisteredAddress","description":"Updates only supplied fields on the existing primary address, or creates a primary address when none exists. Always makes it the default billing address; clears primary and billing flags on the user's other addresses, and their shipping flags if this address is default shipping. Omitted or null leaves addresses unchanged. An empty object updates an existing primary's flags; it fails required-field validation when no primary exists. Does not replace or delete addresses or select one by ID.","x-tags":["Customers"],"properties":{"first_name":{"type":"string","maxLength":128,"minLength":1,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.first_name","typeLabel":"string"},"last_name":{"oneOf":[{"type":"string","maxLength":128,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.last_name.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":128,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.last_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.last_name","typeLabel":"string | null"},"country_code":{"type":"string","maxLength":8,"minLength":1,"pattern":"^\\+?\\d{1,4}$","uniqueKey":"business.oneOf.0.registered_address.oneOf.0.country_code","typeLabel":"string"},"phone":{"description":"10 ASCII digits without country code. Leading zeros are removed after validation.","type":"string","maxLength":16,"minLength":1,"pattern":"^[0-9]{10}$","uniqueKey":"business.oneOf.0.registered_address.oneOf.0.phone","typeLabel":"string"},"email":{"type":"string","format":"email","maxLength":128,"minLength":1,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.email","typeLabel":"string\u003cemail>"},"address_line1":{"type":"string","maxLength":256,"minLength":1,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.address_line1","typeLabel":"string"},"address_line2":{"oneOf":[{"type":"string","maxLength":256,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.address_line2.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.address_line2.oneOf.1","typeLabel":"null"}],"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.address_line2","typeLabel":"string | null"},"landmark":{"oneOf":[{"type":"string","maxLength":128,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.landmark.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":128,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.landmark.oneOf.1","typeLabel":"null"}],"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.landmark","typeLabel":"string | null"},"pincode":{"type":"string","maxLength":6,"minLength":6,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.pincode","typeLabel":"string"},"city":{"type":"string","maxLength":128,"minLength":1,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.city","typeLabel":"string"},"state":{"type":"string","maxLength":128,"minLength":1,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.state","typeLabel":"string"},"country":{"type":"string","maxLength":128,"minLength":1,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.country","typeLabel":"string"},"business_name":{"oneOf":[{"description":"Also fills the customer's business name when it is empty and this value is nonempty.","type":"string","maxLength":128,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.business_name.oneOf.0","typeLabel":"string"},{"description":"Also fills the customer's business name when it is empty and this value is nonempty.","type":"null","maxLength":128,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.business_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.business_name","typeLabel":"string | null"},"tax_identification_number":{"oneOf":[{"type":"string","maxLength":64,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.tax_identification_number.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":64,"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.tax_identification_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"business.oneOf.0.registered_address.oneOf.0.tax_identification_number","typeLabel":"string | null"},"is_default_shipping":{"type":"boolean","uniqueKey":"business.oneOf.0.registered_address.oneOf.0.is_default_shipping","typeLabel":"boolean"}},"uniqueKey":"business.oneOf.0.registered_address.oneOf.0","typeLabel":"UpdateCustomerRegisteredAddress · object"},{"type":"null","description":"Updates only supplied fields on the existing primary address, or creates a primary address when none exists. Always makes it the default billing address; clears primary and billing flags on the user's other addresses, and their shipping flags if this address is default shipping. Omitted or null leaves addresses unchanged. An empty object updates an existing primary's flags; it fails required-field validation when no primary exists. Does not replace or delete addresses or select one by ID.","uniqueKey":"business.oneOf.0.registered_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"business.oneOf.0.registered_address","typeLabel":"UpdateCustomerRegisteredAddress · object | null"},"business_type":{"oneOf":[{"type":"string","title":"CustomerBusinessType","enum":["sole_proprietorship","partnership","private_limited","public_limited","public_listed","state_owned","charity","individual","llp","other"],"uniqueKey":"business.oneOf.0.business_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"business.oneOf.0.business_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"business.oneOf.0.business_type","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"business.oneOf.0","typeLabel":"object"},{"description":"Null or an empty object leaves business details unchanged. Null name or business_type clears that field; null registered_address leaves addresses unchanged.","type":"null","properties":{"name":{"oneOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null","maxLength":255,"minLength":1}]},"registered_address":{"oneOf":[{"type":"object","title":"UpdateCustomerRegisteredAddress","description":"Updates only supplied fields on the existing primary address, or creates a primary address when none exists. Always makes it the default billing address; clears primary and billing flags on the user's other addresses, and their shipping flags if this address is default shipping. Omitted or null leaves addresses unchanged. An empty object updates an existing primary's flags; it fails required-field validation when no primary exists. Does not replace or delete addresses or select one by ID.","x-tags":["Customers"],"properties":{"first_name":{"type":"string","maxLength":128,"minLength":1},"last_name":{"oneOf":[{"type":"string","maxLength":128},{"type":"null","maxLength":128}]},"country_code":{"type":"string","maxLength":8,"minLength":1,"pattern":"^\\+?\\d{1,4}$"},"phone":{"description":"10 ASCII digits without country code. Leading zeros are removed after validation.","type":"string","maxLength":16,"minLength":1,"pattern":"^[0-9]{10}$"},"email":{"type":"string","format":"email","maxLength":128,"minLength":1},"address_line1":{"type":"string","maxLength":256,"minLength":1},"address_line2":{"oneOf":[{"type":"string","maxLength":256},{"type":"null","maxLength":256}]},"landmark":{"oneOf":[{"type":"string","maxLength":128},{"type":"null","maxLength":128}]},"pincode":{"type":"string","maxLength":6,"minLength":6},"city":{"type":"string","maxLength":128,"minLength":1},"state":{"type":"string","maxLength":128,"minLength":1},"country":{"type":"string","maxLength":128,"minLength":1},"business_name":{"oneOf":[{"description":"Also fills the customer's business name when it is empty and this value is nonempty.","type":"string","maxLength":128},{"description":"Also fills the customer's business name when it is empty and this value is nonempty.","type":"null","maxLength":128}]},"tax_identification_number":{"oneOf":[{"type":"string","maxLength":64},{"type":"null","maxLength":64}]},"is_default_shipping":{"type":"boolean"}}},{"type":"null","description":"Updates only supplied fields on the existing primary address, or creates a primary address when none exists. Always makes it the default billing address; clears primary and billing flags on the user's other addresses, and their shipping flags if this address is default shipping. Omitted or null leaves addresses unchanged. An empty object updates an existing primary's flags; it fails required-field validation when no primary exists. Does not replace or delete addresses or select one by ID."}]},"business_type":{"oneOf":[{"type":"string","title":"CustomerBusinessType","enum":["sole_proprietorship","partnership","private_limited","public_limited","public_listed","state_owned","charity","individual","llp","other"]},{"type":"null"}]}},"uniqueKey":"business.oneOf.1","typeLabel":"null"}],"uniqueKey":"business","typeLabel":"object | null"},"tags":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"tags","typeLabel":"string[]"},"attributes":{"description":"Attribute values to set on the customer. Each entry targets an existing store attribute by `key` (its ULID or slug); send `null` as the `value` to clear one. Omit the field to leave attributes unchanged. An empty array leaves existing attributes unchanged.","type":"array","items":{"title":"CustomerAttributePayload","type":"object","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerAttributePayload"},"required":["key","value"],"properties":{"key":{"description":"The target attribute's `id` or `slug`: an `active`, `custom` attribute of the store, read-only ones included. `linked` attributes are set from KYC documents and `system` ones by Commerce Engine: both are refused.","type":"string","isRequired":true,"uniqueKey":"attributes.items.[INDEX].key","typeLabel":"string"},"value":{"oneOf":[{"type":"string","description":"The value, of the attribute's `attribute_type` (a string for `String`, a boolean for `Boolean`, a list for `List`, an ISO 8601 date-time with a time zone for `DateTime`), at most 4 KB as JSON. `null`, an empty string or only spaces clears it.","isRequired":true,"uniqueKey":"attributes.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"number","description":"The value, of the attribute's `attribute_type` (a string for `String`, a boolean for `Boolean`, a list for `List`, an ISO 8601 date-time with a time zone for `DateTime`), at most 4 KB as JSON. `null`, an empty string or only spaces clears it.","isRequired":true,"uniqueKey":"attributes.items.[INDEX].value.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"The value, of the attribute's `attribute_type` (a string for `String`, a boolean for `Boolean`, a list for `List`, an ISO 8601 date-time with a time zone for `DateTime`), at most 4 KB as JSON. `null`, an empty string or only spaces clears it.","isRequired":true,"uniqueKey":"attributes.items.[INDEX].value.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"attributes.items.[INDEX].value.oneOf.3.items.[INDEX]","typeLabel":"any"},"description":"The value, of the attribute's `attribute_type` (a string for `String`, a boolean for `Boolean`, a list for `List`, an ISO 8601 date-time with a time zone for `DateTime`), at most 4 KB as JSON. `null`, an empty string or only spaces clears it.","isRequired":true,"uniqueKey":"attributes.items.[INDEX].value.oneOf.3","typeLabel":"any[]"},{"type":"object","description":"The value, of the attribute's `attribute_type` (a string for `String`, a boolean for `Boolean`, a list for `List`, an ISO 8601 date-time with a time zone for `DateTime`), at most 4 KB as JSON. `null`, an empty string or only spaces clears it.","additionalProperties":true,"isRequired":true,"uniqueKey":"attributes.items.[INDEX].value.oneOf.4","typeLabel":"object"},{"type":"null","description":"The value, of the attribute's `attribute_type` (a string for `String`, a boolean for `Boolean`, a list for `List`, an ISO 8601 date-time with a time zone for `DateTime`), at most 4 KB as JSON. `null`, an empty string or only spaces clears it.","isRequired":true,"uniqueKey":"attributes.items.[INDEX].value.oneOf.5","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attributes.items.[INDEX].value","typeLabel":"string | number | boolean | any[] | object | null"}},"x-tags":["Customers"],"uniqueKey":"attributes.items.[INDEX]","typeLabel":"CustomerAttributePayload · object"},"uniqueKey":"attributes","typeLabel":"CustomerAttributePayload · object[]"},"metadata":{"oneOf":[{"description":"The customer's own data as key-value pairs. Merged into what the customer has: each key sent is set, a key sent as `null` is removed, keys not sent are kept; `null` or `{}` changes nothing. At most 50 keys and 16 KB as JSON.","type":"object","additionalProperties":true,"uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"description":"The customer's own data as key-value pairs. Merged into what the customer has: each key sent is set, a key sent as `null` is removed, keys not sent are kept; `null` or `{}` changes nothing. At most 50 keys and 16 KB as JSON.","type":"null","additionalProperties":true,"uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"}},"x-tags":["Customers"],"uniqueKey":"","typeLabel":"UpdateCustomer · object"},"examples":{"Example":{"title":"Example","value":{"first_name":"\u003cstring>","last_name":"\u003cstring>","email":"jsmith@example.com","phone":"\u003cstring>","country_code":"\u003cstring>","customer_group_id":"\u003cstring>","business":{"name":"\u003cstring>","registered_address":{"first_name":"\u003cstring>","last_name":"\u003cstring>","country_code":"\u003cstring>","phone":"\u003cstring>","email":"jsmith@example.com","address_line1":"\u003cstring>","address_line2":"\u003cstring>","landmark":"\u003cstring>","pincode":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","country":"\u003cstring>","business_name":"\u003cstring>","tax_identification_number":"\u003cstring>","is_default_shipping":true}},"tags":["\u003cstring>"],"attributes":[{"key":"\u003cstring>","value":"\u003cstring>"}],"metadata":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"cba8298e-7197-4590-8fcc-3c4fc6cc38c3":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["message","success","content"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"content":{"properties":{"customer":{"type":"object","title":"CustomerDetail","required":["addresses","banking","loyalty","notification_preferences","attributes","metadata","business","segments","first_name","last_name","full_name","profile_image_url","country_code","status","email","phone","id","is_phone_verified","is_email_verified","is_whatsapp_verified","is_verified","kyc_status","tags","customer_group_id","created_at","modified_at","last_seen"],"x-tags":["Customers"],"properties":{"id":{"description":"Customer ID. An imported customer can have a different primary user ID.","type":"string","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.id","typeLabel":"string"},"first_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.first_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.first_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.last_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.last_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.last_name","typeLabel":"string | null"},"full_name":{"oneOf":[{"type":"string","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.full_name.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.full_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.full_name","typeLabel":"string | null"},"profile_image_url":{"oneOf":[{"type":"string","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.profile_image_url.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.profile_image_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.profile_image_url","typeLabel":"string | null"},"country_code":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.country_code.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.country_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.country_code","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.phone.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.phone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.phone","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.email.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.email","typeLabel":"string | null"},"is_phone_verified":{"type":"boolean","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.is_phone_verified","typeLabel":"boolean"},"is_email_verified":{"type":"boolean","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.is_email_verified","typeLabel":"boolean"},"is_whatsapp_verified":{"type":"boolean","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.is_whatsapp_verified","typeLabel":"boolean"},"status":{"oneOf":[{"type":"null","description":"`null` for customers with no status recorded.","isRequired":true,"uniqueKey":"content.customer.status.oneOf.0","typeLabel":"null"},{"type":"string","title":"CustomerStatus","description":"`null` for customers with no status recorded.","example":"active","isRequired":true,"uniqueKey":"content.customer.status.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"content.customer.status","typeLabel":"null | string"},"created_at":{"type":"string","format":"date-time","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.created_at","typeLabel":"string\u003cdate-time>"},"modified_at":{"type":"string","format":"date-time","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.modified_at","typeLabel":"string\u003cdate-time>"},"last_seen":{"oneOf":[{"description":"Empty string when the customer has no recorded activity yet.","type":"string","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.last_seen.oneOf.0","typeLabel":"string"},{"description":"Empty string when the customer has no recorded activity yet.","type":"null","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.last_seen.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.last_seen","typeLabel":"string | null"},"kyc_status":{"description":"KYC progress for a customer. `document_pending` means required documents have not been uploaded; `submitted` and `submitted_for_approval` mean they are awaiting review.","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/KycStatus"},"enum":["pending","document_pending","submitted","submitted_for_approval","approved","rejected"],"type":"string","isRequired":true,"uniqueKey":"content.customer.kyc_status","typeLabel":"enum\u003cstring>"},"is_verified":{"type":"boolean","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.is_verified","typeLabel":"boolean"},"customer_group_id":{"oneOf":[{"description":"The Customer Group the customer belongs to. Drives group-specific pricing and promotions.","type":"string","isRequired":true,"uniqueKey":"content.customer.customer_group_id.oneOf.0","typeLabel":"string"},{"description":"The Customer Group the customer belongs to. Drives group-specific pricing and promotions.","type":"null","isRequired":true,"uniqueKey":"content.customer.customer_group_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.customer_group_id","typeLabel":"string | null"},"tags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"content.customer.tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"content.customer.tags.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"isRequired":true,"uniqueKey":"content.customer.tags.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.tags","typeLabel":"string[] | null"},"business":{"oneOf":[{"type":"null","description":"Business details for the linked customer, or `null` when no customer is linked. Individual details can be empty or `null`.","isRequired":true,"uniqueKey":"content.customer.business.oneOf.0","typeLabel":"null"},{"type":"object","title":"BusinessInfo","description":"Business details for the linked customer, or `null` when no customer is linked. Individual details can be empty or `null`.","x-tags":["Customers"],"properties":{"name":{"oneOf":[{"type":"string","uniqueKey":"content.customer.business.oneOf.1.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"content.customer.business.oneOf.1.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.business.oneOf.1.name","typeLabel":"string | null"},"business_type":{"oneOf":[{"description":"Stored customer business type. Existing records may contain free text, including a default customer group name from storefront signup. Newly supplied values: sole_proprietorship, partnership, private_limited, public_limited, public_listed, state_owned, charity, individual, llp, other. A value here does not imply the customer is a registered business.","type":"string","uniqueKey":"content.customer.business.oneOf.1.business_type.oneOf.0","typeLabel":"string"},{"description":"Stored customer business type. Existing records may contain free text, including a default customer group name from storefront signup. Newly supplied values: sole_proprietorship, partnership, private_limited, public_limited, public_listed, state_owned, charity, individual, llp, other. A value here does not imply the customer is a registered business.","type":"null","uniqueKey":"content.customer.business.oneOf.1.business_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.business.oneOf.1.business_type","typeLabel":"string | null"},"pan_number":{"oneOf":[{"type":"string","uniqueKey":"content.customer.business.oneOf.1.pan_number.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"content.customer.business.oneOf.1.pan_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.business.oneOf.1.pan_number","typeLabel":"string | null"},"gstin":{"oneOf":[{"type":"string","uniqueKey":"content.customer.business.oneOf.1.gstin.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"content.customer.business.oneOf.1.gstin.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.business.oneOf.1.gstin","typeLabel":"string | null"},"is_registered_under_gst":{"type":"boolean","uniqueKey":"content.customer.business.oneOf.1.is_registered_under_gst","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"content.customer.business.oneOf.1","typeLabel":"BusinessInfo · object"}],"isRequired":true,"uniqueKey":"content.customer.business","typeLabel":"null | BusinessInfo · object"},"segments":{"type":"array","items":{"title":"CustomerSegment","type":"object","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerSegment"},"properties":{"id":{"type":"string","uniqueKey":"content.customer.segments.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.segments.items.[INDEX].name","typeLabel":"string"}},"x-tags":["Customers"],"uniqueKey":"content.customer.segments.items.[INDEX]","typeLabel":"CustomerSegment · object"},"isRequired":true,"uniqueKey":"content.customer.segments","typeLabel":"CustomerSegment · object[]"},"addresses":{"type":"array","items":{"title":"SavedCustomerAddress","type":"object","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/SavedCustomerAddress"},"required":["first_name","phone","email","address_line1","pincode","city","state","country","id","last_name","country_code","address_line2","landmark","gstin","business_name","is_phone_verified","is_email_verified","is_default_shipping","is_default_billing","created_at","modified_at","is_primary"],"properties":{"id":{"type":"string","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].id","typeLabel":"string"},"first_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].first_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].first_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].last_name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].last_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].last_name","typeLabel":"string | null"},"country_code":{"description":"Two-letter code begin with a plus sign prefix that identifies different countries. By default it will be +91 if not provided.\r\n","type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].country_code","typeLabel":"string"},"phone":{"oneOf":[{"description":"10 digit phone number without country code.","type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].phone.oneOf.0","typeLabel":"string"},{"description":"10 digit phone number without country code.","type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].phone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].phone","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].email","typeLabel":"string | null"},"address_line1":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].address_line1.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].address_line1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].address_line1","typeLabel":"string | null"},"address_line2":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].address_line2.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].address_line2.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].address_line2","typeLabel":"string | null"},"landmark":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].landmark.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].landmark.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].landmark","typeLabel":"string | null"},"pincode":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].pincode.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].pincode.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].pincode","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].city.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].city.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].state.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].state.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].state","typeLabel":"string | null"},"country":{"oneOf":[{"description":"Country name. `null` when the address was saved without one.","type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].country.oneOf.0","typeLabel":"string"},{"description":"Country name. `null` when the address was saved without one.","type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].country","typeLabel":"string | null"},"gstin":{"oneOf":[{"description":"Use in shipping details only for third party.","type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].gstin.oneOf.0","typeLabel":"string"},{"description":"Use in shipping details only for third party.","type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].gstin.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].gstin","typeLabel":"string | null"},"business_name":{"oneOf":[{"description":"Use in shipping details only for third party.","type":"string","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].business_name.oneOf.0","typeLabel":"string"},{"description":"Use in shipping details only for third party.","type":"null","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].business_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].business_name","typeLabel":"string | null"},"is_phone_verified":{"type":"boolean","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].is_phone_verified","typeLabel":"boolean"},"is_email_verified":{"type":"boolean","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].is_email_verified","typeLabel":"boolean"},"is_default_shipping":{"type":"boolean","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].is_default_shipping","typeLabel":"boolean"},"is_default_billing":{"type":"boolean","isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].is_default_billing","typeLabel":"boolean"},"created_at":{"type":"string","format":"date-time","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"modified_at":{"type":"string","format":"date-time","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].modified_at","typeLabel":"string\u003cdate-time>"},"is_primary":{"type":"boolean","readOnly":true,"isRequired":true,"uniqueKey":"content.customer.addresses.items.[INDEX].is_primary","typeLabel":"boolean"}},"examples":[],"x-tags":["Customers"],"uniqueKey":"content.customer.addresses.items.[INDEX]","typeLabel":"SavedCustomerAddress · object"},"isRequired":true,"uniqueKey":"content.customer.addresses","typeLabel":"SavedCustomerAddress · object[]"},"banking":{"description":"Bank accounts saved against the customer, used for refunds and payouts.","type":"array","items":{"title":"CustomerBankAccount","type":"object","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerBankAccount"},"required":["account_type","account_name","account_number","ifsc_code","bank_name"],"properties":{"account_type":{"enum":["inbound","outbound"],"type":"string","isRequired":true,"uniqueKey":"content.customer.banking.items.[INDEX].account_type","typeLabel":"enum\u003cstring>"},"account_name":{"type":"string","isRequired":true,"uniqueKey":"content.customer.banking.items.[INDEX].account_name","typeLabel":"string"},"account_number":{"type":"string","isRequired":true,"uniqueKey":"content.customer.banking.items.[INDEX].account_number","typeLabel":"string"},"ifsc_code":{"type":"string","isRequired":true,"uniqueKey":"content.customer.banking.items.[INDEX].ifsc_code","typeLabel":"string"},"bank_name":{"type":"string","isRequired":true,"uniqueKey":"content.customer.banking.items.[INDEX].bank_name","typeLabel":"string"},"id":{"type":"string","readOnly":true,"uniqueKey":"content.customer.banking.items.[INDEX].id","typeLabel":"string"},"is_default":{"description":"default bank account for the customer.","type":"boolean","uniqueKey":"content.customer.banking.items.[INDEX].is_default","typeLabel":"boolean"},"is_verified":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.banking.items.[INDEX].is_verified","typeLabel":"boolean"},"created_at":{"type":"string","format":"date-time","readOnly":true,"uniqueKey":"content.customer.banking.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"modified_at":{"type":"string","format":"date-time","readOnly":true,"uniqueKey":"content.customer.banking.items.[INDEX].modified_at","typeLabel":"string\u003cdate-time>"}},"x-tags":["Customers"],"uniqueKey":"content.customer.banking.items.[INDEX]","typeLabel":"CustomerBankAccount · object"},"isRequired":true,"uniqueKey":"content.customer.banking","typeLabel":"CustomerBankAccount · object[]"},"loyalty":{"oneOf":[{"type":"null","description":"`null` when the customer is not enrolled in a loyalty program.","isRequired":true,"uniqueKey":"content.customer.loyalty.oneOf.0","typeLabel":"null"},{"type":"object","title":"LoyaltyMember","description":"`null` when the customer is not enrolled in a loyalty program.","x-tags":["Customers"],"properties":{"customer_id":{"type":"string","uniqueKey":"content.customer.loyalty.oneOf.1.customer_id","typeLabel":"string"},"customer_name":{"oneOf":[{"type":"string","uniqueKey":"content.customer.loyalty.oneOf.1.customer_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"content.customer.loyalty.oneOf.1.customer_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.loyalty.oneOf.1.customer_name","typeLabel":"string | null"},"membership_number":{"type":"string","uniqueKey":"content.customer.loyalty.oneOf.1.membership_number","typeLabel":"string"},"points_earned":{"description":"total points earned within the current loyalty program.","type":"integer","uniqueKey":"content.customer.loyalty.oneOf.1.points_earned","typeLabel":"integer"},"points_redeemed":{"description":"total points redeemed within the current loyalty program.","type":"integer","uniqueKey":"content.customer.loyalty.oneOf.1.points_redeemed","typeLabel":"integer"},"points_balance":{"description":"total points available.","type":"integer","uniqueKey":"content.customer.loyalty.oneOf.1.points_balance","typeLabel":"integer"},"total_spent":{"description":"The total amount a customer has spent within the current loyalty program, excluding taxes, promotional discounts, and redeemed loyalty points. This value is used to determine tier eligibility and earning points calculation.","type":"number","uniqueKey":"content.customer.loyalty.oneOf.1.total_spent","typeLabel":"number"},"total_orders":{"description":"The total number of completed orders counted in the current loyalty program.","type":"integer","uniqueKey":"content.customer.loyalty.oneOf.1.total_orders","typeLabel":"integer"},"lifetime_spent":{"description":" The total amount a customer has spent across all time, regardless of loyalty program participation. This includes all completed orders and excludes taxes, promotional discounts, and redeemed points.","type":"number","uniqueKey":"content.customer.loyalty.oneOf.1.lifetime_spent","typeLabel":"number"},"lifetime_orders":{"description":"The total number of completed orders across all time, regardless of loyalty program.","type":"integer","uniqueKey":"content.customer.loyalty.oneOf.1.lifetime_orders","typeLabel":"integer"},"date_of_join":{"oneOf":[{"description":" The date and time when the customer first enrolled in the loyalty program.","type":"string","format":"date-time","uniqueKey":"content.customer.loyalty.oneOf.1.date_of_join.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":" The date and time when the customer first enrolled in the loyalty program.","type":"null","format":"date-time","uniqueKey":"content.customer.loyalty.oneOf.1.date_of_join.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.loyalty.oneOf.1.date_of_join","typeLabel":"string\u003cdate-time> | null"},"date_of_assign":{"oneOf":[{"description":"The date and time when the customer's current loyalty tier or program instance was assigned. This may change when tiers are upgraded, downgraded, or reassigned.","type":"string","format":"date-time","uniqueKey":"content.customer.loyalty.oneOf.1.date_of_assign.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"The date and time when the customer's current loyalty tier or program instance was assigned. This may change when tiers are upgraded, downgraded, or reassigned.","type":"null","format":"date-time","uniqueKey":"content.customer.loyalty.oneOf.1.date_of_assign.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.loyalty.oneOf.1.date_of_assign","typeLabel":"string\u003cdate-time> | null"},"date_of_reset":{"oneOf":[{"description":" The date and time when the customer’s current loyalty program cycle will reset, at which points earned, points redeemed, balance points, total spent, total orders will be cleared.","type":"string","format":"date-time","uniqueKey":"content.customer.loyalty.oneOf.1.date_of_reset.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":" The date and time when the customer’s current loyalty program cycle will reset, at which points earned, points redeemed, balance points, total spent, total orders will be cleared.","type":"null","format":"date-time","uniqueKey":"content.customer.loyalty.oneOf.1.date_of_reset.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.loyalty.oneOf.1.date_of_reset","typeLabel":"string\u003cdate-time> | null"},"current_tier":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","uniqueKey":"content.customer.loyalty.oneOf.1.current_tier.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.loyalty.oneOf.1.current_tier.oneOf.0.name","typeLabel":"string"}},"uniqueKey":"content.customer.loyalty.oneOf.1.current_tier.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"string"},"name":{"type":"string"}},"uniqueKey":"content.customer.loyalty.oneOf.1.current_tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.loyalty.oneOf.1.current_tier","typeLabel":"object | null"},"next_tier":{"oneOf":[{"type":"object","description":"null when the member is already on the highest tier","properties":{"id":{"type":"string","uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.0.name","typeLabel":"string"},"total_spent_threshold":{"oneOf":[{"type":"integer","minimum":0,"uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.0.total_spent_threshold.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.0.total_spent_threshold.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.0.total_spent_threshold","typeLabel":"integer | null"},"total_orders_threshold":{"oneOf":[{"type":"integer","minimum":0,"uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.0.total_orders_threshold.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.0.total_orders_threshold.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.0.total_orders_threshold","typeLabel":"integer | null"}},"uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.0","typeLabel":"object"},{"type":"null","description":"null when the member is already on the highest tier","uniqueKey":"content.customer.loyalty.oneOf.1.next_tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.loyalty.oneOf.1.next_tier","typeLabel":"object | null"},"name":{"type":"string","uniqueKey":"content.customer.loyalty.oneOf.1.name","typeLabel":"string"},"renewal_type":{"type":"string","enum":["yearly","never","custom"],"uniqueKey":"content.customer.loyalty.oneOf.1.renewal_type","typeLabel":"enum\u003cstring>"},"tier_upgrade_criteria":{"type":"string","enum":["total-spent","total-orders","custom"],"uniqueKey":"content.customer.loyalty.oneOf.1.tier_upgrade_criteria","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"content.customer.loyalty.oneOf.1","typeLabel":"LoyaltyMember · object"}],"isRequired":true,"uniqueKey":"content.customer.loyalty","typeLabel":"null | LoyaltyMember · object"},"notification_preferences":{"title":"NotificationPreferences","description":"Set channel preferences for each type of ","type":"object","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/NotificationPreferences"},"properties":{"transactional":{"title":"NotificationChannelPreferences","description":"These notifications are typically critical for user engagement, providing updates, confirmations, or alerts related to their account activities.","type":"object","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/NotificationChannelPreferences"},"properties":{"email":{"description":"Indicates whether the user has opted to receive notifications via email.","type":"boolean","default":true,"uniqueKey":"content.customer.notification_preferences.transactional.email","typeLabel":"boolean"},"sms":{"description":"Indicates whether the user has opted to receive notifications via SMS.","type":"boolean","default":true,"uniqueKey":"content.customer.notification_preferences.transactional.sms","typeLabel":"boolean"},"whatsapp":{"description":"Indicates whether the user has opted to receive notifications via WhatsApp.","type":"boolean","default":true,"uniqueKey":"content.customer.notification_preferences.transactional.whatsapp","typeLabel":"boolean"}},"uniqueKey":"content.customer.notification_preferences.transactional","typeLabel":"NotificationChannelPreferences · object"},"promotional":{"description":"These notifications aim to engage users with promotional content and enhance their overall experience with the platform.","type":"object","properties":{"email":{"description":"Indicates whether the user has opted to receive notifications via email.","type":"boolean","default":true,"uniqueKey":"content.customer.notification_preferences.promotional.email","typeLabel":"boolean"},"sms":{"description":"Indicates whether the user has opted to receive notifications via SMS.","type":"boolean","default":false,"uniqueKey":"content.customer.notification_preferences.promotional.sms","typeLabel":"boolean"},"whatsapp":{"description":"Indicates whether the user has opted to receive notifications via WhatsApp.","type":"boolean","default":false,"uniqueKey":"content.customer.notification_preferences.promotional.whatsapp","typeLabel":"boolean"}},"uniqueKey":"content.customer.notification_preferences.promotional","typeLabel":"object"},"newsletter":{"description":"These notifications are often sent periodically as part of a subscription service.\n","type":"object","properties":{"email":{"description":"Indicates whether the user has opted to receive notifications via email.","type":"boolean","default":true,"uniqueKey":"content.customer.notification_preferences.newsletter.email","typeLabel":"boolean"},"sms":{"description":"Indicates whether the user has opted to receive notifications via SMS.","type":"boolean","default":false,"uniqueKey":"content.customer.notification_preferences.newsletter.sms","typeLabel":"boolean"},"whatsapp":{"description":"Indicates whether the user has opted to receive notifications via WhatsApp.","type":"boolean","default":false,"uniqueKey":"content.customer.notification_preferences.newsletter.whatsapp","typeLabel":"boolean"}},"uniqueKey":"content.customer.notification_preferences.newsletter","typeLabel":"object"}},"isRequired":true,"uniqueKey":"content.customer.notification_preferences","typeLabel":"NotificationPreferences · object"},"attributes":{"description":"The customer's values of the store's active `custom` attributes, read-only ones included, each typed by its `attribute_type`; `value` is `null` when none is set. `GET /customers/{id}/attributes` lists every kind.","type":"array","items":{"oneOf":[{"type":"object","title":"StringAttribute","x-tags":["Customers"],"properties":{"id":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.name","typeLabel":"string"},"slug":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.slug","typeLabel":"string"},"kind":{"title":"CustomerAttributeKind","description":"Who sets the attribute's values. `custom`: the store's own attribute, set by admins and, unless it is `is_readonly`, by shoppers in the storefront. `linked`: set from the customer's KYC document of the same type: the document number once it is approved, otherwise `not_submitted`, `submitted` or `rejected`. `system`: set by Commerce Engine, such as the campaign source of a shopper's first and latest visits (`initial-utm-source`, `utm-source`).","type":"string","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerAttributeKind"},"enum":["custom","linked","system"],"readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.kind","typeLabel":"enum\u003cstring>"},"link":{"oneOf":[{"type":"null","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.link.oneOf.0","typeLabel":"null"},{"type":"object","title":"CustomerAttributeLink","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","required":["type","document_type"],"properties":{"type":{"type":"string","enum":["kyc_document"],"isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.link.oneOf.1.type","typeLabel":"enum\u003cstring>"},"document_type":{"description":"Slug of the KYC document type whose document sets the value.","type":"string","isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.link.oneOf.1.document_type","typeLabel":"string"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.link.oneOf.1","typeLabel":"CustomerAttributeLink · object"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.link","typeLabel":"null | CustomerAttributeLink · object"},"is_linked":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.is_linked","typeLabel":"boolean"},"value":{"oneOf":[{"description":"`null` when no value is set for this customer.","type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.value.oneOf.0","typeLabel":"string"},{"description":"`null` when no value is set for this customer.","type":"null","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.value","typeLabel":"string | null"},"attribute_type":{"enum":["String"],"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.attribute_type","typeLabel":"enum\u003cstring>"},"is_readonly":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.is_readonly","typeLabel":"boolean"},"is_pinned":{"description":"Whether the attribute is pinned to the top of the customer profile.","type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.is_pinned","typeLabel":"boolean"},"active":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.active","typeLabel":"boolean"},"is_visible":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.is_visible","typeLabel":"boolean"},"is_filterable":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.is_filterable","typeLabel":"boolean"},"last_updated_at":{"type":"string","format":"date-time","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0.last_updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.0","typeLabel":"StringAttribute · object"},{"type":"object","title":"IntegerAttribute","x-tags":["Customers"],"properties":{"id":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.name","typeLabel":"string"},"slug":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.slug","typeLabel":"string"},"kind":{"title":"CustomerAttributeKind","description":"Who sets the attribute's values. `custom`: the store's own attribute, set by admins and, unless it is `is_readonly`, by shoppers in the storefront. `linked`: set from the customer's KYC document of the same type: the document number once it is approved, otherwise `not_submitted`, `submitted` or `rejected`. `system`: set by Commerce Engine, such as the campaign source of a shopper's first and latest visits (`initial-utm-source`, `utm-source`).","type":"string","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerAttributeKind"},"enum":["custom","linked","system"],"readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.kind","typeLabel":"enum\u003cstring>"},"link":{"oneOf":[{"type":"null","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.link.oneOf.0","typeLabel":"null"},{"type":"object","title":"CustomerAttributeLink","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","required":["type","document_type"],"properties":{"type":{"type":"string","enum":["kyc_document"],"isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.link.oneOf.1.type","typeLabel":"enum\u003cstring>"},"document_type":{"description":"Slug of the KYC document type whose document sets the value.","type":"string","isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.link.oneOf.1.document_type","typeLabel":"string"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.link.oneOf.1","typeLabel":"CustomerAttributeLink · object"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.link","typeLabel":"null | CustomerAttributeLink · object"},"is_linked":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.is_linked","typeLabel":"boolean"},"value":{"oneOf":[{"description":"`null` when no value is set for this customer.","type":"integer","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.value.oneOf.0","typeLabel":"integer"},{"description":"`null` when no value is set for this customer.","type":"null","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.value","typeLabel":"integer | null"},"attribute_type":{"enum":["Integer"],"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.attribute_type","typeLabel":"enum\u003cstring>"},"is_readonly":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.is_readonly","typeLabel":"boolean"},"is_pinned":{"description":"Whether the attribute is pinned to the top of the customer profile.","type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.is_pinned","typeLabel":"boolean"},"active":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.active","typeLabel":"boolean"},"is_visible":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.is_visible","typeLabel":"boolean"},"is_filterable":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.is_filterable","typeLabel":"boolean"},"last_updated_at":{"type":"string","format":"date-time","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1.last_updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.1","typeLabel":"IntegerAttribute · object"},{"type":"object","title":"NumberAttribute","x-tags":["Customers"],"properties":{"id":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.name","typeLabel":"string"},"slug":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.slug","typeLabel":"string"},"kind":{"title":"CustomerAttributeKind","description":"Who sets the attribute's values. `custom`: the store's own attribute, set by admins and, unless it is `is_readonly`, by shoppers in the storefront. `linked`: set from the customer's KYC document of the same type: the document number once it is approved, otherwise `not_submitted`, `submitted` or `rejected`. `system`: set by Commerce Engine, such as the campaign source of a shopper's first and latest visits (`initial-utm-source`, `utm-source`).","type":"string","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerAttributeKind"},"enum":["custom","linked","system"],"readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.kind","typeLabel":"enum\u003cstring>"},"link":{"oneOf":[{"type":"null","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.link.oneOf.0","typeLabel":"null"},{"type":"object","title":"CustomerAttributeLink","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","required":["type","document_type"],"properties":{"type":{"type":"string","enum":["kyc_document"],"isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.link.oneOf.1.type","typeLabel":"enum\u003cstring>"},"document_type":{"description":"Slug of the KYC document type whose document sets the value.","type":"string","isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.link.oneOf.1.document_type","typeLabel":"string"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.link.oneOf.1","typeLabel":"CustomerAttributeLink · object"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.link","typeLabel":"null | CustomerAttributeLink · object"},"is_linked":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.is_linked","typeLabel":"boolean"},"value":{"oneOf":[{"description":"`null` when no value is set for this customer.","type":"number","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.value.oneOf.0","typeLabel":"number"},{"description":"`null` when no value is set for this customer.","type":"null","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.value","typeLabel":"number | null"},"attribute_type":{"enum":["Number"],"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.attribute_type","typeLabel":"enum\u003cstring>"},"is_readonly":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.is_readonly","typeLabel":"boolean"},"is_pinned":{"description":"Whether the attribute is pinned to the top of the customer profile.","type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.is_pinned","typeLabel":"boolean"},"active":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.active","typeLabel":"boolean"},"is_visible":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.is_visible","typeLabel":"boolean"},"is_filterable":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.is_filterable","typeLabel":"boolean"},"last_updated_at":{"type":"string","format":"date-time","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2.last_updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.2","typeLabel":"NumberAttribute · object"},{"type":"object","title":"BooleanAttribute","x-tags":["Customers"],"properties":{"id":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.name","typeLabel":"string"},"slug":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.slug","typeLabel":"string"},"kind":{"title":"CustomerAttributeKind","description":"Who sets the attribute's values. `custom`: the store's own attribute, set by admins and, unless it is `is_readonly`, by shoppers in the storefront. `linked`: set from the customer's KYC document of the same type: the document number once it is approved, otherwise `not_submitted`, `submitted` or `rejected`. `system`: set by Commerce Engine, such as the campaign source of a shopper's first and latest visits (`initial-utm-source`, `utm-source`).","type":"string","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerAttributeKind"},"enum":["custom","linked","system"],"readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.kind","typeLabel":"enum\u003cstring>"},"link":{"oneOf":[{"type":"null","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.link.oneOf.0","typeLabel":"null"},{"type":"object","title":"CustomerAttributeLink","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","required":["type","document_type"],"properties":{"type":{"type":"string","enum":["kyc_document"],"isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.link.oneOf.1.type","typeLabel":"enum\u003cstring>"},"document_type":{"description":"Slug of the KYC document type whose document sets the value.","type":"string","isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.link.oneOf.1.document_type","typeLabel":"string"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.link.oneOf.1","typeLabel":"CustomerAttributeLink · object"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.link","typeLabel":"null | CustomerAttributeLink · object"},"is_linked":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.is_linked","typeLabel":"boolean"},"value":{"oneOf":[{"description":"`null` when no value is set for this customer.","type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.value.oneOf.0","typeLabel":"boolean"},{"description":"`null` when no value is set for this customer.","type":"null","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.value","typeLabel":"boolean | null"},"attribute_type":{"enum":["Boolean"],"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.attribute_type","typeLabel":"enum\u003cstring>"},"is_readonly":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.is_readonly","typeLabel":"boolean"},"is_pinned":{"description":"Whether the attribute is pinned to the top of the customer profile.","type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.is_pinned","typeLabel":"boolean"},"active":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.active","typeLabel":"boolean"},"is_visible":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.is_visible","typeLabel":"boolean"},"is_filterable":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.is_filterable","typeLabel":"boolean"},"last_updated_at":{"type":"string","format":"date-time","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3.last_updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.3","typeLabel":"BooleanAttribute · object"},{"type":"object","title":"ListAttribute","x-tags":["Customers"],"properties":{"id":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.name","typeLabel":"string"},"slug":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.slug","typeLabel":"string"},"kind":{"title":"CustomerAttributeKind","description":"Who sets the attribute's values. `custom`: the store's own attribute, set by admins and, unless it is `is_readonly`, by shoppers in the storefront. `linked`: set from the customer's KYC document of the same type: the document number once it is approved, otherwise `not_submitted`, `submitted` or `rejected`. `system`: set by Commerce Engine, such as the campaign source of a shopper's first and latest visits (`initial-utm-source`, `utm-source`).","type":"string","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerAttributeKind"},"enum":["custom","linked","system"],"readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.kind","typeLabel":"enum\u003cstring>"},"link":{"oneOf":[{"type":"null","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.link.oneOf.0","typeLabel":"null"},{"type":"object","title":"CustomerAttributeLink","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","required":["type","document_type"],"properties":{"type":{"type":"string","enum":["kyc_document"],"isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.link.oneOf.1.type","typeLabel":"enum\u003cstring>"},"document_type":{"description":"Slug of the KYC document type whose document sets the value.","type":"string","isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.link.oneOf.1.document_type","typeLabel":"string"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.link.oneOf.1","typeLabel":"CustomerAttributeLink · object"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.link","typeLabel":"null | CustomerAttributeLink · object"},"is_linked":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.is_linked","typeLabel":"boolean"},"value":{"oneOf":[{"description":"`null` when no value is set for this customer.","type":"array","items":{"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.value.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.value.oneOf.0","typeLabel":"string[]"},{"description":"`null` when no value is set for this customer.","type":"null","items":{"type":"string"},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.value","typeLabel":"string[] | null"},"attribute_type":{"enum":["List"],"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.attribute_type","typeLabel":"enum\u003cstring>"},"is_readonly":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.is_readonly","typeLabel":"boolean"},"is_pinned":{"description":"Whether the attribute is pinned to the top of the customer profile.","type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.is_pinned","typeLabel":"boolean"},"active":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.active","typeLabel":"boolean"},"is_visible":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.is_visible","typeLabel":"boolean"},"is_filterable":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.is_filterable","typeLabel":"boolean"},"last_updated_at":{"type":"string","format":"date-time","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4.last_updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.4","typeLabel":"ListAttribute · object"},{"type":"object","title":"ObjectAttribute","x-tags":["Customers"],"properties":{"id":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.name","typeLabel":"string"},"slug":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.slug","typeLabel":"string"},"kind":{"title":"CustomerAttributeKind","description":"Who sets the attribute's values. `custom`: the store's own attribute, set by admins and, unless it is `is_readonly`, by shoppers in the storefront. `linked`: set from the customer's KYC document of the same type: the document number once it is approved, otherwise `not_submitted`, `submitted` or `rejected`. `system`: set by Commerce Engine, such as the campaign source of a shopper's first and latest visits (`initial-utm-source`, `utm-source`).","type":"string","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerAttributeKind"},"enum":["custom","linked","system"],"readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.kind","typeLabel":"enum\u003cstring>"},"link":{"oneOf":[{"type":"null","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.link.oneOf.0","typeLabel":"null"},{"type":"object","title":"CustomerAttributeLink","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","required":["type","document_type"],"properties":{"type":{"type":"string","enum":["kyc_document"],"isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.link.oneOf.1.type","typeLabel":"enum\u003cstring>"},"document_type":{"description":"Slug of the KYC document type whose document sets the value.","type":"string","isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.link.oneOf.1.document_type","typeLabel":"string"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.link.oneOf.1","typeLabel":"CustomerAttributeLink · object"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.link","typeLabel":"null | CustomerAttributeLink · object"},"is_linked":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.is_linked","typeLabel":"boolean"},"value":{"oneOf":[{"description":"`null` when no value is set for this customer.","type":"object","additionalProperties":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.value.oneOf.0","typeLabel":"object"},{"description":"`null` when no value is set for this customer.","type":"null","additionalProperties":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.value","typeLabel":"object | null"},"attribute_type":{"enum":["Object"],"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.attribute_type","typeLabel":"enum\u003cstring>"},"is_readonly":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.is_readonly","typeLabel":"boolean"},"is_pinned":{"description":"Whether the attribute is pinned to the top of the customer profile.","type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.is_pinned","typeLabel":"boolean"},"active":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.active","typeLabel":"boolean"},"is_visible":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.is_visible","typeLabel":"boolean"},"is_filterable":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.is_filterable","typeLabel":"boolean"},"last_updated_at":{"type":"string","format":"date-time","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5.last_updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.5","typeLabel":"ObjectAttribute · object"},{"type":"object","title":"DateTimeAttribute","x-tags":["Customers"],"properties":{"id":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.name","typeLabel":"string"},"slug":{"type":"string","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.slug","typeLabel":"string"},"kind":{"title":"CustomerAttributeKind","description":"Who sets the attribute's values. `custom`: the store's own attribute, set by admins and, unless it is `is_readonly`, by shoppers in the storefront. `linked`: set from the customer's KYC document of the same type: the document number once it is approved, otherwise `not_submitted`, `submitted` or `rejected`. `system`: set by Commerce Engine, such as the campaign source of a shopper's first and latest visits (`initial-utm-source`, `utm-source`).","type":"string","externalDocs":{"url":"https://llm-docs.commercengine.io/admin-pos/schemas/CustomerAttributeKind"},"enum":["custom","linked","system"],"readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.kind","typeLabel":"enum\u003cstring>"},"link":{"oneOf":[{"type":"null","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.link.oneOf.0","typeLabel":"null"},{"type":"object","title":"CustomerAttributeLink","description":"Where a `linked` attribute's values come from; `null` for the other kinds.","required":["type","document_type"],"properties":{"type":{"type":"string","enum":["kyc_document"],"isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.link.oneOf.1.type","typeLabel":"enum\u003cstring>"},"document_type":{"description":"Slug of the KYC document type whose document sets the value.","type":"string","isRequired":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.link.oneOf.1.document_type","typeLabel":"string"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.link.oneOf.1","typeLabel":"CustomerAttributeLink · object"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.link","typeLabel":"null | CustomerAttributeLink · object"},"is_linked":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.is_linked","typeLabel":"boolean"},"value":{"oneOf":[{"description":"`null` when no value is set for this customer.","type":"string","format":"date-time","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.value.oneOf.0","typeLabel":"string\u003cdate-time>"},{"description":"`null` when no value is set for this customer.","type":"null","format":"date-time","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.value","typeLabel":"string\u003cdate-time> | null"},"attribute_type":{"enum":["DateTime"],"type":"string","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.attribute_type","typeLabel":"enum\u003cstring>"},"is_readonly":{"type":"boolean","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.is_readonly","typeLabel":"boolean"},"is_pinned":{"description":"Whether the attribute is pinned to the top of the customer profile.","type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.is_pinned","typeLabel":"boolean"},"active":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.active","typeLabel":"boolean"},"is_visible":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.is_visible","typeLabel":"boolean"},"is_filterable":{"type":"boolean","uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.is_filterable","typeLabel":"boolean"},"last_updated_at":{"type":"string","format":"date-time","readOnly":true,"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6.last_updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"content.customer.attributes.items.[INDEX].oneOf.6","typeLabel":"DateTimeAttribute · object"}],"uniqueKey":"content.customer.attributes.items.[INDEX]","typeLabel":"StringAttribute · object | IntegerAttribute · object | NumberAttribute · object | BooleanAttribute · object | ListAttribute · object | ObjectAttribute · object | DateTimeAttribute · object"},"isRequired":true,"uniqueKey":"content.customer.attributes","typeLabel":"(StringAttribute · object | IntegerAttribute · object | NumberAttribute · object | BooleanAttribute · object | ListAttribute · object | ObjectAttribute · object | DateTimeAttribute · object)[]"},"metadata":{"oneOf":[{"description":"The customer's own data as key-value pairs; `null` when none was ever set.","type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"content.customer.metadata.oneOf.0","typeLabel":"object"},{"description":"The customer's own data as key-value pairs; `null` when none was ever set.","type":"null","additionalProperties":true,"isRequired":true,"uniqueKey":"content.customer.metadata.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"content.customer.metadata","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"content.customer","typeLabel":"CustomerDetail · object"}},"required":["customer"],"type":"object","isRequired":true,"uniqueKey":"content","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","success":true,"content":{"customer":{"id":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","full_name":"\u003cstring>","profile_image_url":"\u003cstring>","country_code":"\u003cstring>","phone":"\u003cstring>","email":"\u003cstring>","is_phone_verified":true,"is_email_verified":true,"is_whatsapp_verified":true,"status":"active","created_at":"2023-11-07T05:31:56Z","modified_at":"2023-11-07T05:31:56Z","last_seen":"\u003cstring>","kyc_status":"pending","is_verified":true,"customer_group_id":"\u003cstring>","tags":["\u003cstring>"],"business":{"name":"\u003cstring>","business_type":"\u003cstring>","pan_number":"\u003cstring>","gstin":"\u003cstring>","is_registered_under_gst":true},"segments":[{"id":"\u003cstring>","name":"\u003cstring>"}],"addresses":[{"id":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","country_code":"\u003cstring>","phone":"\u003cstring>","email":"\u003cstring>","address_line1":"\u003cstring>","address_line2":"\u003cstring>","landmark":"\u003cstring>","pincode":"\u003cstring>","city":"\u003cstring>","state":"\u003cstring>","country":"\u003cstring>","gstin":"\u003cstring>","business_name":"\u003cstring>","is_phone_verified":true,"is_email_verified":true,"is_default_shipping":true,"is_default_billing":true,"created_at":"2023-11-07T05:31:56Z","modified_at":"2023-11-07T05:31:56Z","is_primary":true}],"banking":[{"account_type":"inbound","account_name":"\u003cstring>","account_number":"\u003cstring>","ifsc_code":"\u003cstring>","bank_name":"\u003cstring>","id":"\u003cstring>","is_default":true,"is_verified":true,"created_at":"2023-11-07T05:31:56Z","modified_at":"2023-11-07T05:31:56Z"}],"loyalty":{"customer_id":"\u003cstring>","customer_name":"\u003cstring>","membership_number":"\u003cstring>","points_earned":123,"points_redeemed":123,"points_balance":123,"total_spent":123,"total_orders":123,"lifetime_spent":123,"lifetime_orders":123,"date_of_join":"2023-11-07T05:31:56Z","date_of_assign":"2023-11-07T05:31:56Z","date_of_reset":"2023-11-07T05:31:56Z","current_tier":{"id":"\u003cstring>","name":"\u003cstring>"},"next_tier":{"id":"\u003cstring>","name":"\u003cstring>","total_spent_threshold":1,"total_orders_threshold":1},"name":"\u003cstring>","renewal_type":"yearly","tier_upgrade_criteria":"total-spent"},"notification_preferences":{"transactional":{"email":true,"sms":true,"whatsapp":true},"promotional":{"email":true,"sms":false,"whatsapp":false},"newsletter":{"email":true,"sms":false,"whatsapp":false}},"attributes":[{"id":"\u003cstring>","name":"\u003cstring>","slug":"\u003cstring>","kind":"custom","link":{"type":"kyc_document","document_type":"\u003cstring>"},"is_linked":true,"value":"\u003cstring>","attribute_type":"String","is_readonly":true,"is_pinned":true,"active":true,"is_visible":true,"is_filterable":true,"last_updated_at":"2023-11-07T05:31:56Z"}],"metadata":{}}}}}},"exampleType":"generated"}},"exampleType":"generated"},"99b2d815-12a5-4f8a-868a-e60f578023e8":{"description":"The request is invalid or cannot be completed in the current state.","content":{"application/json":{"schema":{"type":"object","required":["message","success"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"errors":{"oneOf":[{"type":"object","description":"Validation details as a field map, a bulk list or a string.","additionalProperties":true,"uniqueKey":"errors.oneOf.0","typeLabel":"object"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"errors.oneOf.1.items.[INDEX]","typeLabel":"any"},"description":"Validation details as a field map, a bulk list or a string.","uniqueKey":"errors.oneOf.1","typeLabel":"any[]"},{"type":"string","description":"Validation details as a field map, a bulk list or a string.","uniqueKey":"errors.oneOf.2","typeLabel":"string"}],"uniqueKey":"errors","typeLabel":"object | any[] | string"},"content":{"type":"object","additionalProperties":true,"uniqueKey":"content","typeLabel":"object"},"details":{"type":"string","uniqueKey":"details","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","success":true,"code":"\u003cstring>","errors":{},"content":{},"details":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"005f8502-6da6-41bd-9482-e68a4e2a48cc":{"description":"The token is missing, invalid or expired, or does not grant access to this store and operation.","content":{"application/json":{"schema":{"type":"object","required":["message","success"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"details":{"type":"string","uniqueKey":"details","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","success":true,"code":"\u003cstring>","details":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c9437079-d040-4956-a5cd-dc72c7b160e2":{"description":"Access denied. `token-required` requires an authenticated session; `permission-denied` means the caller cannot access this resource. On POS, `session-expired` requires signing in again.","content":{"application/json":{"schema":{"type":"object","required":["code","message","success"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","x-speakeasy-error-message":true,"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"details":{"type":"string","uniqueKey":"details","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","message":"\u003cstring>","success":true,"details":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4e958157-826f-494d-b5e1-4807731c4226":{"description":"The requested resource was not found.","content":{"application/json":{"schema":{"type":"object","required":["message","success"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"details":{"type":"string","uniqueKey":"details","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","success":true,"code":"\u003cstring>","details":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"94b352cf-9854-47a3-9847-fb4c99c8e75a":{"description":"The request could not be completed. Quote error_id, when present, when contacting support.","content":{"application/json":{"schema":{"type":"object","required":["message","success"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"details":{"type":"string","uniqueKey":"details","typeLabel":"string"},"error_id":{"type":"string","uniqueKey":"error_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","success":true,"code":"\u003cstring>","details":"\u003cstring>","error_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"487e3883-99f2-4310-bf3e-4fe5660ab755":{"description":"The request timed out.","content":{"application/json":{"schema":{"type":"object","required":["code","message","success"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","x-speakeasy-error-message":true,"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"details":{"type":"string","uniqueKey":"details","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","message":"\u003cstring>","success":true,"details":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"423393ac-717c-4334-9571-10ca10e70bf6":{"Authorization":{"type":"http","description":"Access token","scheme":"bearer","scopes":[],"schemeName":"Authorization"}}},"servers":{"d5140fa8-2bd5-4c13-abb4-72a9479f9f58":{"url":"https://staging.api.commercengine.io/api/v1/{store_id}/storefront","description":"Staging Server","variables":{"store_id":{"description":"Store ID","default":"store_id"}},"x-speakeasy-server-id":"staging"},"503d314f-8bfe-43e5-9c58-f8d1033bbbb9":{"url":"https://prod.api.commercengine.io/api/v1/{store_id}/storefront","description":"Prod Server","variables":{"store_id":{"description":"Store ID","default":"store_id"}},"x-speakeasy-server-id":"prod"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"Access token","scheme":"bearer","scopes":[],"schemeName":"Authorization"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Access token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Authorization","name":"Authorization"}],"title":"Authorization"}]},"originalFileLocation":"https://openapi.commercengine.io/ce-pos.json"},"subdomain":"tarkai","siteName":"Commerce Engine Docs","title":"Update customer - Commerce Engine Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T13:06:39.429Z","originalFileLocation":"api-reference/pos/customers/update-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=\"Updates a customer\u0026#x27;s profile and returns the updated CustomerDetail object. Change customer_group_id to move the customer to a different Customer Group, which drives group-specific pricing and promotions.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Commerce Engine Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_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=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update customer - Commerce Engine Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Updates a customer\u0026#x27;s profile and returns the updated CustomerDetail object. Change customer_group_id to move the customer to a different Customer Group, which drives group-specific pricing and promotions.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Commerce Engine Developer Portal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tarkai.mintlify.site/docs/_mintlify/api/og/v2?division=Customers\u0026amp;title=Update+customer\u0026amp;description=Updates+a+customer%27s+profile+and+returns+the+updated+%60CustomerDetail%60+object.+Change+%60customer_group_id%60+to+move+the+customer+to+a+different+Customer+Group%2C+whi\u0026amp;theme=76e8f8f14f90cfb8929bc40a\u0026amp;signature=9999dba8e6f694b668d6acafd115ecbfc518b22a5c63a8f81e01859e67bbe50e\">\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=\"Update customer - Commerce Engine Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Updates a customer\u0026#x27;s profile and returns the updated CustomerDetail object. Change customer_group_id to move the customer to a different Customer Group, which drives group-specific pricing and promotions.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tarkai.mintlify.site/docs/_mintlify/api/og/v2?division=Customers\u0026amp;title=Update+customer\u0026amp;description=Updates+a+customer%27s+profile+and+returns+the+updated+%60CustomerDetail%60+object.+Change+%60customer_group_id%60+to+move+the+customer+to+a+different+Customer+Group%2C+whi\u0026amp;theme=76e8f8f14f90cfb8929bc40a\u0026amp;signature=9999dba8e6f694b668d6acafd115ecbfc518b22a5c63a8f81e01859e67bbe50e\">\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=\"/docs/mintlify-assets/_mintlify/favicons/tarkai/OqQIjYq8Q24cGlMx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Commerce Engine Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00BF6F\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:logo\" content=\"/logo/CE_logo_whitebg.svg\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/pos/customers/update-customer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.commercengine.io/#organization\",\"name\":\"Commerce Engine Docs\",\"url\":\"https://www.commercengine.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tarkai/hIY7_H2biaAvOGu7/logo/CE_Developers_black.svg?fit=max\u0026auto=format\u0026n=hIY7_H2biaAvOGu7\u0026q=85\u0026s=d93f21564dfd373c7f2efc88c9d4301e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.commercengine.io/docs#website\",\"name\":\"Commerce Engine Docs\",\"url\":\"https://www.commercengine.io/docs\",\"publisher\":{\"@id\":\"https://www.commercengine.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer#webpage\",\"url\":\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer\",\"name\":\"Update customer\",\"description\":\"Updates a customer's profile and returns the updated CustomerDetail object. Change customer_group_id to move the customer to a different Customer Group, which drives group-specific pricing and promotions.\",\"dateModified\":\"2026-11-18T13:06:39.429Z\",\"isPartOf\":{\"@id\":\"https://www.commercengine.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Customers\",\"item\":\"https://www.commercengine.io/docs/api-reference/pos/customers/list-all-customers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Customers\",\"item\":\"https://www.commercengine.io/docs/api-reference/pos/customers/list-all-customers\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update customer\",\"item\":\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer#apireference\",\"headline\":\"Update customer\",\"name\":\"Update customer\",\"description\":\"Updates a customer's profile and returns the updated CustomerDetail object. Change customer_group_id to move the customer to a different Customer Group, which drives group-specific pricing and promotions.\",\"url\":\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer\",\"mainEntityOfPage\":{\"@id\":\"https://www.commercengine.io/docs/api-reference/pos/customers/update-customer#webpage\"},\"dateModified\":\"2026-11-18T13:06:39.429Z\",\"publisher\":{\"@id\":\"https://www.commercengine.io/#organization\"},\"isPartOf\":{\"@id\":\"https://www.commercengine.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Commerce Engine Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Commerce Engine Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/pos/customers/update-customer.md","siteName":"Commerce Engine Docs","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open-cover","menu":[{"item":"Quickstart","icon":"rocket","description":"Get your keys, then make your first API call in under 15 minutes.","pages":[{"title":"Quickstart","href":"/storefront/quickstart"}]},{"item":"Starters","icon":"rocket","description":"Three production storefronts, each cloned across five frameworks.","pages":[{"title":"Starters","href":"/starters/overview"}]},{"item":"AI-assisted development","icon":"wand-magic-sparkles","description":"Skills, prompts and starters for coding agents.","pages":[{"title":"AI-assisted development","href":"/ai/overview"}]},{"item":"AI apps","icon":"plug","description":"Manage your store from Claude, ChatGPT, Codex and other AI apps.","pages":[{"title":"AI apps","href":"/ai/mcp-connector"}]},{"item":"Storefront","icon":"store","description":"Auth, catalog, cart, checkout, account and subscriptions.","pages":[{"title":"Storefront","href":"/storefront/authentication"}]},{"item":"API guides","icon":"code","description":"Authentication, POS setup and webhook delivery.","pages":[{"title":"API guides","href":"/api-reference/getting-started"}]},{"item":"Hosted checkout","icon":"bag-shopping","description":"Drop-in embeddable cart and checkout for any stack.","pages":[{"title":"Hosted checkout","href":"/hosted-checkout/overview"}]},{"item":"SEO \u0026 AEO","icon":"magnifying-glass","description":"Structured data, canonical metadata, sitemaps and llms.txt.","pages":[{"title":"SEO \u0026 AEO","href":"/seo-ai/overview"}]},{"item":"Agent tools","icon":"robot","description":"WebMCP tools that let browser agents shop your store.","pages":[{"title":"Agent tools","href":"/seo-ai/ai"}]}],"pages":[{"title":"Guides","href":"/storefront/quickstart"}]},{"tab":"Hosted Checkout","icon":"bag-shopping","pages":[{"title":"Hosted Checkout","href":"/hosted-checkout/overview"}]},{"tab":"Packages","icon":"cube","menu":[{"item":"storefront","icon":"box","description":"Framework wrappers for React, Next.js, SvelteKit and Astro.","pages":[{"title":"storefront","href":"/sdk/installation"}]},{"item":"ssr-utils","icon":"server","description":"Framework-agnostic cookie-backed SSR session utilities.","pages":[{"title":"ssr-utils","href":"/sdk/ssr-utils"}]},{"item":"checkout","icon":"bag-shopping","description":"Universal checkout SDK — hosted, embedded or headless.","pages":[{"title":"checkout","href":"/hosted-checkout/overview"}]},{"item":"pos","icon":"cash-register","description":"TypeScript SDK for the POS API, for in-store selling.","pages":[{"title":"pos","href":"/pos/overview"}]},{"item":"analytics","icon":"chart-line","description":"Zero-dependency mappers for canonical commerce events.","pages":[{"title":"analytics","href":"/hosted-checkout/analytics"}]},{"item":"seo","icon":"magnifying-glass","description":"Opinionated SEO, AEO, structured data and Markdown output.","pages":[{"title":"seo","href":"/seo-ai/overview"}]},{"item":"ai","icon":"wand-magic-sparkles","description":"Browser-native agent tools (WebMCP) for storefronts.","pages":[{"title":"ai","href":"/seo-ai/ai"}]},{"item":"Browse all packages","icon":"grid-2","description":"Every published Commerce Engine package on npm.","href":"https://www.npmjs.com/org/commercengine"}],"pages":[{"title":"Packages","href":"/sdk/installation"}]},{"tab":"API Reference","icon":"code","menu":[{"item":"Storefront API","icon":"store","description":"Everything a storefront calls — catalog, cart, checkout, auth, orders.","pages":[{"title":"Storefront API","href":"/api-reference/authentication/create-anonymous-session"}]},{"item":"POS API","icon":"cash-register","description":"Point of sale — staff login, device pairing, carts, catalog and order capture on the storefront base URL.","groups":[{"group":"Identity","pages":[{"group":"Devices","pages":[{"title":"Pair POS device","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/auth/pair-device","href":"/api-reference/pos/devices/pair-pos-device"},{"title":"List all available devices","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/devices","href":"/api-reference/pos/devices/list-all-available-devices"},{"title":"Claim device","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/devices/{id}/claim","href":"/api-reference/pos/devices/claim-device"},{"title":"Unclaim device","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/devices/{id}/unclaim","href":"/api-reference/pos/devices/unclaim-device"},{"title":"List all locations","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/locations","href":"/api-reference/pos/devices/list-all-locations"}]},{"group":"Authentication","pages":[{"title":"Login with email","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/auth/login/email","href":"/api-reference/pos/authentication/login-with-email"},{"title":"Login with phone","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/auth/login/phone","href":"/api-reference/pos/authentication/login-with-phone"},{"title":"Login with whatsapp","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/auth/login/whatsapp","href":"/api-reference/pos/authentication/login-with-whatsapp"},{"title":"Logout","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/auth/logout","href":"/api-reference/pos/authentication/logout"},{"title":"Refresh POS access token","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/auth/refresh-token","href":"/api-reference/pos/authentication/refresh-pos-access-token"},{"title":"Verify OTP","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/auth/verify-otp","href":"/api-reference/pos/authentication/verify-otp"}]},{"group":"Users","pages":[{"title":"Get POS User","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/users/{id}","href":"/api-reference/pos/users/get-pos-user"}]}]},{"group":"Customers","pages":[{"group":"Customers","pages":[{"title":"List all customers","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/customers","href":"/api-reference/pos/customers/list-all-customers"},{"title":"Retrieve customer detail","description":"Retrieves the full `CustomerDetail` object, including `business`, `segments`, `addresses`, `banking`, `loyalty`, `notification_preferences`, and the assigned `customer_group_id`.","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/customers/{id}","href":"/api-reference/pos/customers/retrieve-customer-detail"},{"title":"Update customer","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json put /pos/customers/{id}","href":"/api-reference/pos/customers/update-customer"},{"title":"Search customers","description":"Searches customers for selection at the till, with facets and pagination.","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/search-customers","href":"/api-reference/pos/customers/search-customers"}]},{"group":"Addresses","pages":[{"title":"List all addresses","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/customers/{id}/addresses","href":"/api-reference/pos/addresses/list-all-addresses"},{"title":"Create address","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/customers/{id}/addresses","href":"/api-reference/pos/addresses/create-address"},{"title":"Update address detail","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json put /pos/customers/{id}/addresses/{address_id}","href":"/api-reference/pos/addresses/update-address-detail"},{"title":"Delete address","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json delete /pos/customers/{id}/addresses/{address_id}","href":"/api-reference/pos/addresses/delete-address"}]}]},{"group":"Catalog","pages":[{"group":"Products","pages":[{"title":"List all products","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/products","href":"/api-reference/pos/products/list-all-products"},{"title":"Retrieve cross-sell products","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/products/cross-sell","href":"/api-reference/pos/products/retrieve-cross-sell-products"},{"title":"Search products","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/catalog/products/search","href":"/api-reference/pos/products/search-products"},{"title":"Retrieve similar products","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/products/similar","href":"/api-reference/pos/products/retrieve-similar-products"},{"title":"Retrieve up-sell products","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/products/up-sell","href":"/api-reference/pos/products/retrieve-up-sell-products"},{"title":"Retrieve a product detail","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/products/{product_id}","href":"/api-reference/pos/products/retrieve-a-product-detail"},{"title":"Retrieve product variants","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/products/{product_id}/variants","href":"/api-reference/pos/products/retrieve-product-variants"},{"title":"Retrieve variant detail","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/products/{product_id}/variants/{variant_id}","href":"/api-reference/pos/products/retrieve-variant-detail"},{"title":"List all SKUs","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/skus","href":"/api-reference/pos/products/list-all-skus"}]},{"group":"Reviews","pages":[{"title":"List all product reviews","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/products/{product_id}/reviews","href":"/api-reference/pos/reviews/list-all-product-reviews"}]},{"group":"Categories","pages":[{"title":"List all categories","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/categories","href":"/api-reference/pos/categories/list-all-categories"}]},{"group":"Inventory","pages":[{"title":"List all inventories","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/inventories","href":"/api-reference/pos/inventory/list-all-inventories"},{"title":"List all inventories activities","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/inventories/activities","href":"/api-reference/pos/inventory/list-all-inventories-activities"},{"title":"Retrieve inventory detail","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/catalog/inventories/detail","href":"/api-reference/pos/inventory/retrieve-inventory-detail"}]}]},{"group":"Shopping","pages":[{"group":"Carts","pages":[{"title":"Create cart","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/carts","href":"/api-reference/pos/carts/create-cart"},{"title":"Retrieve cart by user ID","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/carts/users/{user_id}","href":"/api-reference/pos/carts/retrieve-cart-by-user-id"},{"title":"Retrieve cart detail","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/carts/{id}","href":"/api-reference/pos/carts/retrieve-cart-detail"},{"title":"Delete cart","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json delete /pos/carts/{id}","href":"/api-reference/pos/carts/delete-cart"},{"title":"Set cart address","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/carts/{id}/address","href":"/api-reference/pos/carts/set-cart-address"},{"title":"Use credit balance","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/carts/{id}/credit-balance","href":"/api-reference/pos/carts/use-credit-balance"},{"title":"Remove credit balance","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json delete /pos/carts/{id}/credit-balance","href":"/api-reference/pos/carts/remove-credit-balance"},{"title":"Add, update, or remove a cart item","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/carts/{id}/items","href":"/api-reference/pos/carts/add-update-or-remove-a-cart-item"},{"title":"Redeem loyalty points","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/carts/{id}/loyalty-points","href":"/api-reference/pos/carts/redeem-loyalty-points"},{"title":"Remove loyalty points","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json delete /pos/carts/{id}/loyalty-points","href":"/api-reference/pos/carts/remove-loyalty-points"},{"title":"Update cart customer","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/carts/{id}/update-customer","href":"/api-reference/pos/carts/update-cart-customer"}]},{"group":"Coupons \u0026 promotions","pages":[{"title":"Retrieve all coupons","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/carts/available-coupons","href":"/api-reference/pos/coupons-\u0026-promotions/retrieve-all-coupons"},{"title":"Retrieve all promotions","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/carts/available-promotions","href":"/api-reference/pos/coupons-\u0026-promotions/retrieve-all-promotions"},{"title":"Apply coupon","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/carts/{id}/coupon","href":"/api-reference/pos/coupons-\u0026-promotions/apply-coupon"},{"title":"Remove coupon","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json delete /pos/carts/{id}/coupon","href":"/api-reference/pos/coupons-\u0026-promotions/remove-coupon"},{"title":"Evaluate coupons","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/carts/{id}/evaluate-coupons","href":"/api-reference/pos/coupons-\u0026-promotions/evaluate-coupons"},{"title":"Evaluate promotions","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/carts/{id}/evaluate-promotions","href":"/api-reference/pos/coupons-\u0026-promotions/evaluate-promotions"}]},{"group":"Fulfillment","pages":[{"title":"Retrieve fulfillment options","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/carts/fulfillment-options","href":"/api-reference/pos/fulfillment/retrieve-fulfillment-options"},{"title":"Update fulfillment preference","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/carts/{id}/fulfillment-preference","href":"/api-reference/pos/fulfillment/update-fulfillment-preference"}]}]},{"group":"Orders","pages":[{"group":"Orders","pages":[{"title":"List all orders","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/orders","href":"/api-reference/pos/orders/list-all-orders"},{"title":"Create POS order","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/orders","href":"/api-reference/pos/orders/create-pos-order"},{"title":"Retrieve order details","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/orders/{order_number}","href":"/api-reference/pos/orders/retrieve-order-details"},{"title":"List all order activity","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/orders/{order_number}/activity","href":"/api-reference/pos/orders/list-all-order-activity"},{"title":"Check inventory","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/orders/{order_number}/check-inventory","href":"/api-reference/pos/orders/check-inventory"},{"title":"Retrieve order invoice","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/orders/{order_number}/invoice","href":"/api-reference/pos/orders/retrieve-order-invoice"},{"title":"Retrieve order receipt","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/orders/{order_number}/receipt","href":"/api-reference/pos/orders/retrieve-order-receipt"},{"title":"Retrieve order shipments","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/orders/{order_number}/shipments","href":"/api-reference/pos/orders/retrieve-order-shipments"}]},{"group":"Order payments","pages":[{"title":"Cancel payment request","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/orders/{order_number}/cancel-payment-request","href":"/api-reference/pos/order-payments/cancel-payment-request"},{"title":"Retrieve payment status","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/orders/{order_number}/payment-status","href":"/api-reference/pos/order-payments/retrieve-payment-status"},{"title":"Create order payment","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/orders/{order_number}/payments","href":"/api-reference/pos/order-payments/create-order-payment"},{"title":"Retry payment","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/orders/{order_number}/retry-payment","href":"/api-reference/pos/order-payments/retry-payment"}]},{"group":"Shipments","pages":[{"title":"List all shipments","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/shipping/shipments","href":"/api-reference/pos/shipments/list-all-shipments"},{"title":"Refund shortfall","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/shipping/shipments/{order_number}/refund-shortfall","href":"/api-reference/pos/shipments/refund-shortfall"},{"title":"Wait for inventory","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/shipping/shipments/{order_number}/wait-for-inventory","href":"/api-reference/pos/shipments/wait-for-inventory"},{"title":"Retrieve shipment detail","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/shipping/shipments/{reference_number}","href":"/api-reference/pos/shipments/retrieve-shipment-detail"},{"title":"Retrieve shipment activities","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/shipping/shipments/{reference_number}/activities","href":"/api-reference/pos/shipments/retrieve-shipment-activities"},{"title":"Approve shipment","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/shipping/shipments/{reference_number}/approve","href":"/api-reference/pos/shipments/approve-shipment"},{"title":"Retrieve shipment invoice","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/shipping/shipments/{reference_number}/invoice","href":"/api-reference/pos/shipments/retrieve-shipment-invoice"},{"title":"Update shipment detail","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json put /pos/shipping/shipments/{reference_number}/manual-update","href":"/api-reference/pos/shipments/update-shipment-detail"},{"title":"Reject shipment","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/shipping/shipments/{reference_number}/reject","href":"/api-reference/pos/shipments/reject-shipment"},{"title":"Create a replacement shipment","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/shipping/shipments/{reference_number}/replacement","href":"/api-reference/pos/shipments/create-a-replacement-shipment"}]}]},{"group":"Payments","pages":[{"group":"Payments","pages":[{"title":"Authenticate direct OTP","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/payments/authenticate-direct-otp","href":"/api-reference/pos/payments/authenticate-direct-otp"},{"title":"Get card information","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/payments/card-info","href":"/api-reference/pos/payments/get-card-information"},{"title":"List payment methods","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/payments/payment-methods","href":"/api-reference/pos/payments/list-payment-methods"},{"title":"Resend direct OTP","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json post /pos/payments/resend-direct-otp","href":"/api-reference/pos/payments/resend-direct-otp"},{"title":"Verify VPA","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/payments/verify-vpa","href":"/api-reference/pos/payments/verify-vpa"}]}]},{"group":"Store","pages":[{"group":"Locations","pages":[{"title":"Retrieve pincodes","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/common/countries/{country_iso_code}/pincodes","href":"/api-reference/pos/locations/retrieve-pincodes"},{"title":"Retrieve country wise states","deprecated":null,"version":null,"openapi":"https://openapi.commercengine.io/ce-pos.json get /pos/common/countries/{country_iso_code}/states","href":"/api-reference/pos/locations/retrieve-country-wise-states"}]}]}]},{"item":"Webhooks","icon":"webhook","description":"Events Commerce Engine delivers to your endpoints — orders, payments, shipments, catalog, customers, store and marketplace.","pages":[{"title":"Webhooks","href":"/api-reference/webhooks/orders/checkout-completed"}]},{"item":"Admin API","icon":"gear","description":"Back-office operations — catalog management, customers, fulfilment, store settings.","pages":[{"title":"Admin API","href":"/admin/api-reference/products/list-all-products"}]}]}]},"basePath":"","title":"Update customer - Commerce Engine Docs","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","Page--B9YZ09u.js","CodeSnippet-CTZvgJfu.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","getApiPlaygroundDisplay-BK2o1XYu.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}