An API key linked to a Program in LoyaltyLion, with a set of permissions (scopes). API keys can be created manually, or acquired through an OAuth2 flow. The API key should be provided as a Bearer token in the Authorization header
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LoyaltyLion","colors":{"primary":"#7533f2","light":"#BEAAFF","dark":"#5C18D6"},"logo":{"light":"https://mintcdn.com/loyaltylion/qoWgzO-fbs5_an5D/logo/loyaltylion-logo-black.svg?fit=max\u0026auto=format\u0026n=qoWgzO-fbs5_an5D\u0026q=85\u0026s=a8042001d5f93ef344ce190752bfba7d","dark":"https://mintcdn.com/loyaltylion/qoWgzO-fbs5_an5D/logo/loyaltylion-logo-white.svg?fit=max\u0026auto=format\u0026n=qoWgzO-fbs5_an5D\u0026q=85\u0026s=37ab9b9089a7e1a44d13df2ae9398de1"},"favicon":"https://mintcdn.com/loyaltylion/qoWgzO-fbs5_an5D/images/favicon.svg?fit=max\u0026auto=format\u0026n=qoWgzO-fbs5_an5D\u0026q=85\u0026s=2d71e6cbb2847c7a83d1d3a4abb6d05e","api":{"playground":{"display":"simple"}},"background":{"color":{}},"navbar":{"links":[{"href":"https://status.loyaltylion.com","label":"Status"},{"href":"https://help.loyaltylion.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.loyaltylion.com"}},"footer":{"socials":{"x":"https://x.com/loyaltylionhq","github":"https://github.com/loyaltylion","linkedin":"https://linkedin.com/company/loyaltylion"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"loyaltylion","hasAudioNarration":false,"actualSubdomain":"loyaltylion","customDomains":["developers.loyaltylion.com"],"gitSource":{"type":"github","owner":"loyaltylion","repo":"dev-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"issues":true,"edits":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af2e52e926281184454cffc","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Admin API","count":67},{"language":"default","tag":"Resources","count":56},{"language":"default","tag":"SDK","count":37},{"language":"default","tag":"Headless API","count":34},{"language":"default","tag":"Webhooks","count":25},{"language":"default","tag":"Webhook events","count":21},{"language":"default","tag":"Embeddable components","count":15},{"language":"default","tag":"Customers","count":13},{"language":"default","tag":"LoyaltyLion SDK","count":13},{"language":"default","tag":"Standalone components","count":12}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".not-prose.mb-6{display:flex;flex-wrap:wrap;gap:0 1.5rem}.not-prose.mb-6>li{margin-left:0!important}"}],"page":{"pagePath":"api-reference/v2/resources/customers/update-customer","slug":"/api-reference/v2/resources/customers/update-customer","pageMetadata":{"title":"Update Customer","version":"v2","openapi":"api-reference/v2/openapi.json PATCH /v2/customers/{merchant_id}","description":null,"href":"/api-reference/v2/resources/customers/update-customer"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update Customer","version":"v2","openapi":"api-reference/v2/openapi.json PATCH /v2/customers/{merchant_id}","description":null,"href":"/api-reference/v2/resources/customers/update-customer"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["customers"],"security":["4e315c9c-a04d-4d32-9d6b-3d3cab85c7ac","6cf9448e-46b2-46cd-8017-dc1fb5881bb5"],"parameters":["f9073684-6642-47f6-88db-91df71626869"],"operationId":"customers.updateCustomer","requestBody":"eebe14af-0d69-49d6-b3b9-b9d061750c50","responses":{"200":"6b91f457-5e66-456c-9664-0b9437b9e32e","400":"bdb9c641-0278-416f-a897-0742256a58bb","401":"601d164b-abea-4588-b1bd-dfdce598cb0c","403":"b363c587-1787-4d43-bc3e-bd6b4f95bc7e","404":"65aabd7b-e90d-4d93-b730-6ea4019c6f1a"},"method":"patch","type":"path","servers":["a8460179-01e1-40c9-803d-13bf195187d2"],"path":"/v2/customers/{merchant_id}","baseUrlOptions":["https://api.loyaltylion.com"],"title":"","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f9073684-6642-47f6-88db-91df71626869":{"name":"merchant_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The ID of the customer in your platform or ecommerce store","uniqueKey":"","typeLabel":"string"},"description":"The ID of the customer in your platform or ecommerce store"}},"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"customer":{"type":"object","properties":{"birthday":{"type":"string","uniqueKey":"customer.birthday","typeLabel":"string"},"blocked":{"type":"boolean","uniqueKey":"customer.blocked","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer","typeLabel":"object"}},"required":["customer"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customer":{"birthday":"\u003cstring>","blocked":true}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6b91f457-5e66-456c-9664-0b9437b9e32e":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"customer":{"type":"object","properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"customer.id","typeLabel":"number"},"merchant_id":{"type":"string","isRequired":true,"uniqueKey":"customer.merchant_id","typeLabel":"string"},"email":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"customer.email.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"customer.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.email","typeLabel":"string | null"},"points_approved":{"type":"number","isRequired":true,"uniqueKey":"customer.points_approved","typeLabel":"number"},"points_pending":{"type":"number","isRequired":true,"uniqueKey":"customer.points_pending","typeLabel":"number"},"points_spent":{"type":"number","isRequired":true,"uniqueKey":"customer.points_spent","typeLabel":"number"},"properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"customer.properties.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"customer.properties","typeLabel":"object"},"metadata":{"type":"object","properties":{"shopify_source_url":{"type":"string","uniqueKey":"customer.metadata.shopify_source_url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.metadata","typeLabel":"object"},"rewards_claimed":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"customer.rewards_claimed","typeLabel":"integer"},"rewards_used":{"oneOf":[{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"customer.rewards_used.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"customer.rewards_used.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.rewards_used","typeLabel":"integer | null"},"blocked":{"type":"boolean","isRequired":true,"uniqueKey":"customer.blocked","typeLabel":"boolean"},"guest":{"type":"boolean","isRequired":true,"uniqueKey":"customer.guest","typeLabel":"boolean"},"enrolled":{"type":"boolean","isRequired":true,"uniqueKey":"customer.enrolled","typeLabel":"boolean"},"enrolled_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"customer.enrolled_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"customer.enrolled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.enrolled_at","typeLabel":"string | null"},"referral_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"customer.referral_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"customer.referral_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.referral_id","typeLabel":"string | null"},"referred_by":{"oneOf":[{"type":"object","required":["id","merchant_id"],"properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"customer.referred_by.oneOf.0.id","typeLabel":"number"},"merchant_id":{"type":"string","isRequired":true,"uniqueKey":"customer.referred_by.oneOf.0.merchant_id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.referred_by.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"customer.referred_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.referred_by","typeLabel":"object | null"},"loyalty_tier_membership":{"oneOf":[{"type":"object","description":"Details of the customer's current tier membership, or `null` if the customer doesn't have one — e.g. guests, blocked or unenrolled customers, or programs without tiers enabled","required":["started_at","expires_at","manual","loyalty_tier"],"properties":{"started_at":{"type":"string","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.started_at","typeLabel":"string"},"expires_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.expires_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.expires_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.expires_at","typeLabel":"string | null"},"manual":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.manual.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.manual.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.manual","typeLabel":"boolean | null"},"loyalty_tier":{"type":"object","properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.id","typeLabel":"number"},"name":{"type":"string","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.name","typeLabel":"string"},"number":{"type":"number","minimum":1,"isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.number","typeLabel":"number"},"default":{"type":"boolean","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.default","typeLabel":"boolean"},"hidden":{"type":"boolean","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.hidden","typeLabel":"boolean"},"lower_bound":{"type":"string","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.lower_bound","typeLabel":"string"},"upper_bound":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.upper_bound.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.upper_bound.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.upper_bound","typeLabel":"string | null"},"position":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier.position","typeLabel":"number"}},"required":["id","name","number","default","hidden","lower_bound","upper_bound","position"],"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0.loyalty_tier","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.0","typeLabel":"object"},{"type":"null","description":"Details of the customer's current tier membership, or `null` if the customer doesn't have one — e.g. guests, blocked or unenrolled customers, or programs without tiers enabled","isRequired":true,"uniqueKey":"customer.loyalty_tier_membership.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.loyalty_tier_membership","typeLabel":"object | null"},"tier_eligibility":{"oneOf":[{"type":"object","title":"Points","required":["kind","valid_until","tier_points","points_needed_for_renewal","points_needed_for_upgrade","upgrade_tier","forecasted_tier"],"properties":{"kind":{"type":"string","const":"points","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.kind","typeLabel":"string"},"valid_until":{"oneOf":[{"type":"string","description":"ISO 8601 timestamp representing when the calculated progress is no longer accurate. After this date, progress values may be stale — for example, because contributing activities, spend, or qualifying orders have fallen outside the evaluation window. Null for lifetime tiers.","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.valid_until.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"ISO 8601 timestamp representing when the calculated progress is no longer accurate. After this date, progress values may be stale — for example, because contributing activities, spend, or qualifying orders have fallen outside the evaluation window. Null for lifetime tiers.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.valid_until.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.valid_until","typeLabel":"string\u003cdate-time> | null"},"tier_points":{"type":"object","properties":{"now":{"type":"number","description":"The number of points contributing to tier progress as of right now. This is equivalent to the number of eligible points from now, back to the start of the evaluation window.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.tier_points.now","typeLabel":"number"},"at_expiration":{"oneOf":[{"description":"The predicted number of points contributing to tier progress as of the current tier's expiration date. Null if the membership never expires (e.g. lifetime tiers).","type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.tier_points.at_expiration.oneOf.0","typeLabel":"number"},{"description":"The predicted number of points contributing to tier progress as of the current tier's expiration date. Null if the membership never expires (e.g. lifetime tiers).","type":"null","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.tier_points.at_expiration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.tier_points.at_expiration","typeLabel":"number | null"}},"required":["now","at_expiration"],"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.tier_points","typeLabel":"object"},"points_needed_for_renewal":{"oneOf":[{"description":"The number of additional points required to renew the current tier when the current membership expires. Null if the membership does not expire (e.g. lifetime tiers), or if the current membership is for the default tier.","type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.points_needed_for_renewal.oneOf.0","typeLabel":"number"},{"description":"The number of additional points required to renew the current tier when the current membership expires. Null if the membership does not expire (e.g. lifetime tiers), or if the current membership is for the default tier.","type":"null","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.points_needed_for_renewal.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.points_needed_for_renewal","typeLabel":"number | null"},"points_needed_for_upgrade":{"oneOf":[{"description":"The number of additional points required to move into the next tier. Null if there is no eligible next tier.","type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.points_needed_for_upgrade.oneOf.0","typeLabel":"number"},{"description":"The number of additional points required to move into the next tier. Null if there is no eligible next tier.","type":"null","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.points_needed_for_upgrade.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.points_needed_for_upgrade","typeLabel":"number | null"},"upgrade_tier":{"oneOf":[{"type":"object","description":"The next tier that this customer could upgrade to from their current tier. Null if the customer is already at the highest tier.","required":["id","name","threshold"],"properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.upgrade_tier.oneOf.0.id","typeLabel":"number"},"name":{"type":"string","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.upgrade_tier.oneOf.0.name","typeLabel":"string"},"threshold":{"type":"number","description":"The threshold required to reach this tier. For points programs, this is the number of points. For spend programs, this is the spend amount in minor units (e.g. cents); the currency is determined by the program configuration. For order-count programs, this is the number of qualifying orders.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.upgrade_tier.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.upgrade_tier.oneOf.0","typeLabel":"object"},{"type":"null","description":"The next tier that this customer could upgrade to from their current tier. Null if the customer is already at the highest tier.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.upgrade_tier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.upgrade_tier","typeLabel":"object | null"},"forecasted_tier":{"oneOf":[{"type":"object","description":"The tier the customer is forecasted to be in at their membership expiration, based on their predicted points at expiration. Null if the membership never expires (e.g. lifetime tiers, default tier memberships, or conditional tier memberships).","required":["id","name"],"properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.forecasted_tier.oneOf.0.id","typeLabel":"number"},"name":{"type":"string","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.forecasted_tier.oneOf.0.name","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.forecasted_tier.oneOf.0","typeLabel":"object"},{"type":"null","description":"The tier the customer is forecasted to be in at their membership expiration, based on their predicted points at expiration. Null if the membership never expires (e.g. lifetime tiers, default tier memberships, or conditional tier memberships).","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.forecasted_tier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0.forecasted_tier","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.0","typeLabel":"Points · object"},{"type":"object","title":"Spend","required":["kind","valid_until","tier_spend","spend_needed_for_renewal","spend_needed_for_upgrade","upgrade_tier","forecasted_tier"],"properties":{"kind":{"type":"string","const":"spend","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.kind","typeLabel":"string"},"valid_until":{"oneOf":[{"type":"string","description":"ISO 8601 timestamp representing when the calculated progress is no longer accurate. After this date, progress values may be stale — for example, because contributing activities, spend, or qualifying orders have fallen outside the evaluation window. Null for lifetime tiers.","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.valid_until.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"ISO 8601 timestamp representing when the calculated progress is no longer accurate. After this date, progress values may be stale — for example, because contributing activities, spend, or qualifying orders have fallen outside the evaluation window. Null for lifetime tiers.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.valid_until.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.valid_until","typeLabel":"string\u003cdate-time> | null"},"tier_spend":{"type":"object","properties":{"now":{"type":"object","properties":{"amount":{"type":"number","example":9.9,"description":"Currency amount as a numeric value. This may be an integer or a float depending on the value and the currency. Currencies that do not use a decimal point will always be an integer","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.tier_spend.now.amount","typeLabel":"number"},"formatted":{"type":"string","example":"$9.90","description":"Formatted amount as string with currency symbol, e.g. `$50` or `$10.50`","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.tier_spend.now.formatted","typeLabel":"string"}},"required":["amount","formatted"],"additionalProperties":false,"title":"Currency","description":"The amount of spend contributing to tier progress as of right now. This is equivalent to the amount of eligible spend from now, back to the start of the evaluation window.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.tier_spend.now","typeLabel":"Currency · object"},"at_expiration":{"oneOf":[{"type":"object","title":"Currency","description":"The predicted amount of spend contributing to tier progress as of the current tier's expiration date. Null if the membership never expires (e.g. lifetime tiers).","required":["amount","formatted"],"properties":{"amount":{"type":"number","example":9.9,"description":"Currency amount as a numeric value. This may be an integer or a float depending on the value and the currency. Currencies that do not use a decimal point will always be an integer","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.tier_spend.at_expiration.oneOf.0.amount","typeLabel":"number"},"formatted":{"type":"string","example":"$9.90","description":"Formatted amount as string with currency symbol, e.g. `$50` or `$10.50`","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.tier_spend.at_expiration.oneOf.0.formatted","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.tier_spend.at_expiration.oneOf.0","typeLabel":"Currency · object"},{"type":"null","description":"The predicted amount of spend contributing to tier progress as of the current tier's expiration date. Null if the membership never expires (e.g. lifetime tiers).","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.tier_spend.at_expiration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.tier_spend.at_expiration","typeLabel":"Currency · object | null"}},"required":["now","at_expiration"],"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.tier_spend","typeLabel":"object"},"spend_needed_for_renewal":{"oneOf":[{"type":"object","title":"Currency","description":"The amount of additional spend required to renew the current tier when the current membership expires. Null if the membership does not expire (e.g. lifetime tiers), or if the current membership is for the default tier.","required":["amount","formatted"],"properties":{"amount":{"type":"number","example":9.9,"description":"Currency amount as a numeric value. This may be an integer or a float depending on the value and the currency. Currencies that do not use a decimal point will always be an integer","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_renewal.oneOf.0.amount","typeLabel":"number"},"formatted":{"type":"string","example":"$9.90","description":"Formatted amount as string with currency symbol, e.g. `$50` or `$10.50`","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_renewal.oneOf.0.formatted","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_renewal.oneOf.0","typeLabel":"Currency · object"},{"type":"null","description":"The amount of additional spend required to renew the current tier when the current membership expires. Null if the membership does not expire (e.g. lifetime tiers), or if the current membership is for the default tier.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_renewal.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_renewal","typeLabel":"Currency · object | null"},"spend_needed_for_upgrade":{"oneOf":[{"type":"object","title":"Currency","description":"The amount of additional spend required to move into the next tier. Null if there is no eligible next tier.","required":["amount","formatted"],"properties":{"amount":{"type":"number","example":9.9,"description":"Currency amount as a numeric value. This may be an integer or a float depending on the value and the currency. Currencies that do not use a decimal point will always be an integer","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_upgrade.oneOf.0.amount","typeLabel":"number"},"formatted":{"type":"string","example":"$9.90","description":"Formatted amount as string with currency symbol, e.g. `$50` or `$10.50`","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_upgrade.oneOf.0.formatted","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_upgrade.oneOf.0","typeLabel":"Currency · object"},{"type":"null","description":"The amount of additional spend required to move into the next tier. Null if there is no eligible next tier.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_upgrade.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.spend_needed_for_upgrade","typeLabel":"Currency · object | null"},"upgrade_tier":{"oneOf":[{"type":"object","description":"The next tier that this customer could upgrade to from their current tier. Null if the customer is already at the highest tier.","required":["id","name","threshold"],"properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.upgrade_tier.oneOf.0.id","typeLabel":"number"},"name":{"type":"string","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.upgrade_tier.oneOf.0.name","typeLabel":"string"},"threshold":{"type":"number","description":"The threshold required to reach this tier. For points programs, this is the number of points. For spend programs, this is the spend amount in minor units (e.g. cents); the currency is determined by the program configuration. For order-count programs, this is the number of qualifying orders.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.upgrade_tier.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.upgrade_tier.oneOf.0","typeLabel":"object"},{"type":"null","description":"The next tier that this customer could upgrade to from their current tier. Null if the customer is already at the highest tier.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.upgrade_tier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.upgrade_tier","typeLabel":"object | null"},"forecasted_tier":{"oneOf":[{"type":"object","description":"The tier the customer is forecasted to be in at their membership expiration, based on their predicted spend at expiration. Null if the membership never expires (e.g. lifetime tiers, default tier memberships, or conditional tier memberships).","required":["id","name"],"properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.forecasted_tier.oneOf.0.id","typeLabel":"number"},"name":{"type":"string","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.forecasted_tier.oneOf.0.name","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.forecasted_tier.oneOf.0","typeLabel":"object"},{"type":"null","description":"The tier the customer is forecasted to be in at their membership expiration, based on their predicted spend at expiration. Null if the membership never expires (e.g. lifetime tiers, default tier memberships, or conditional tier memberships).","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.forecasted_tier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1.forecasted_tier","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.1","typeLabel":"Spend · object"},{"type":"object","title":"Orders","required":["kind","valid_until","tier_orders","orders_needed_for_renewal","orders_needed_for_upgrade","upgrade_tier","forecasted_tier"],"properties":{"kind":{"type":"string","const":"orders","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.kind","typeLabel":"string"},"valid_until":{"oneOf":[{"type":"string","description":"ISO 8601 timestamp representing when the calculated progress is no longer accurate. After this date, progress values may be stale — for example, because contributing activities, spend, or qualifying orders have fallen outside the evaluation window. Null for lifetime tiers.","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.valid_until.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"ISO 8601 timestamp representing when the calculated progress is no longer accurate. After this date, progress values may be stale — for example, because contributing activities, spend, or qualifying orders have fallen outside the evaluation window. Null for lifetime tiers.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.valid_until.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.valid_until","typeLabel":"string\u003cdate-time> | null"},"tier_orders":{"type":"object","properties":{"now":{"type":"number","description":"The number of orders contributing to tier progress as of right now. This is equivalent to the number of eligible orders from now, back to the start of the evaluation window.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.tier_orders.now","typeLabel":"number"},"at_expiration":{"oneOf":[{"description":"The predicted number of orders contributing to tier progress as of the current tier's expiration date. Null if the membership never expires (e.g. lifetime tiers).","type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.tier_orders.at_expiration.oneOf.0","typeLabel":"number"},{"description":"The predicted number of orders contributing to tier progress as of the current tier's expiration date. Null if the membership never expires (e.g. lifetime tiers).","type":"null","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.tier_orders.at_expiration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.tier_orders.at_expiration","typeLabel":"number | null"}},"required":["now","at_expiration"],"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.tier_orders","typeLabel":"object"},"orders_needed_for_renewal":{"oneOf":[{"description":"The number of additional orders required to renew the current tier when the current membership expires. Null if the membership does not expire (e.g. lifetime tiers), or if the current membership is for the default tier.","type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.orders_needed_for_renewal.oneOf.0","typeLabel":"number"},{"description":"The number of additional orders required to renew the current tier when the current membership expires. Null if the membership does not expire (e.g. lifetime tiers), or if the current membership is for the default tier.","type":"null","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.orders_needed_for_renewal.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.orders_needed_for_renewal","typeLabel":"number | null"},"orders_needed_for_upgrade":{"oneOf":[{"description":"The number of additional orders required to move into the next tier. Null if there is no eligible next tier.","type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.orders_needed_for_upgrade.oneOf.0","typeLabel":"number"},{"description":"The number of additional orders required to move into the next tier. Null if there is no eligible next tier.","type":"null","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.orders_needed_for_upgrade.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.orders_needed_for_upgrade","typeLabel":"number | null"},"upgrade_tier":{"oneOf":[{"type":"object","description":"The next tier that this customer could upgrade to from their current tier. Null if the customer is already at the highest tier.","required":["id","name","threshold"],"properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.upgrade_tier.oneOf.0.id","typeLabel":"number"},"name":{"type":"string","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.upgrade_tier.oneOf.0.name","typeLabel":"string"},"threshold":{"type":"number","description":"The threshold required to reach this tier. For points programs, this is the number of points. For spend programs, this is the spend amount in minor units (e.g. cents); the currency is determined by the program configuration. For order-count programs, this is the number of qualifying orders.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.upgrade_tier.oneOf.0.threshold","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.upgrade_tier.oneOf.0","typeLabel":"object"},{"type":"null","description":"The next tier that this customer could upgrade to from their current tier. Null if the customer is already at the highest tier.","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.upgrade_tier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.upgrade_tier","typeLabel":"object | null"},"forecasted_tier":{"oneOf":[{"type":"object","description":"The tier the customer is forecasted to be in at their membership expiration, based on their predicted orders at expiration. Null if the membership never expires (e.g. lifetime tiers, default tier memberships, or conditional tier memberships).","required":["id","name"],"properties":{"id":{"type":"number","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.forecasted_tier.oneOf.0.id","typeLabel":"number"},"name":{"type":"string","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.forecasted_tier.oneOf.0.name","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.forecasted_tier.oneOf.0","typeLabel":"object"},{"type":"null","description":"The tier the customer is forecasted to be in at their membership expiration, based on their predicted orders at expiration. Null if the membership never expires (e.g. lifetime tiers, default tier memberships, or conditional tier memberships).","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.forecasted_tier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2.forecasted_tier","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.2","typeLabel":"Orders · object"},{"type":"null","isRequired":true,"uniqueKey":"customer.tier_eligibility.oneOf.3","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.tier_eligibility","typeLabel":"Points · object | Spend · object | Orders · object | null"},"insights_segment":{"oneOf":[{"type":"string","enum":["At Risk","Win Back","Loyal"],"isRequired":true,"uniqueKey":"customer.insights_segment.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"customer.insights_segment.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.insights_segment","typeLabel":"enum\u003cstring> | null"},"birthday":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"customer.birthday.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"customer.birthday.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.birthday","typeLabel":"string | null"},"referral_url":{"type":"string","isRequired":true,"uniqueKey":"customer.referral_url","typeLabel":"string"},"receipt_upload_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"customer.receipt_upload_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"customer.receipt_upload_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.receipt_upload_url","typeLabel":"string | null"},"loyalty_pass_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"customer.loyalty_pass_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"customer.loyalty_pass_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customer.loyalty_pass_url","typeLabel":"string | null"},"loyalty_pass_installed":{"type":"boolean","isRequired":true,"uniqueKey":"customer.loyalty_pass_installed","typeLabel":"boolean"},"created_at":{"type":"string","isRequired":true,"uniqueKey":"customer.created_at","typeLabel":"string"},"updated_at":{"type":"string","isRequired":true,"uniqueKey":"customer.updated_at","typeLabel":"string"},"linked_merchant_ids":{"type":"array","items":{"type":"string","uniqueKey":"customer.linked_merchant_ids.items.[INDEX]","typeLabel":"string"},"uniqueKey":"customer.linked_merchant_ids","typeLabel":"string[]"}},"required":["id","merchant_id","email","points_approved","points_pending","points_spent","properties","metadata","rewards_claimed","rewards_used","blocked","guest","enrolled","enrolled_at","referral_id","referred_by","loyalty_tier_membership","tier_eligibility","insights_segment","birthday","referral_url","receipt_upload_url","loyalty_pass_url","loyalty_pass_installed","created_at","updated_at"],"additionalProperties":false,"isRequired":true,"uniqueKey":"customer","typeLabel":"object"}},"required":["customer"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customer":{"id":123,"merchant_id":"\u003cstring>","email":"\u003cstring>","points_approved":123,"points_pending":123,"points_spent":123,"properties":{},"metadata":{"shopify_source_url":"\u003cstring>"},"rewards_claimed":1,"rewards_used":1,"blocked":true,"guest":true,"enrolled":true,"enrolled_at":"\u003cstring>","referral_id":"\u003cstring>","referred_by":{"id":123,"merchant_id":"\u003cstring>"},"loyalty_tier_membership":{"started_at":"\u003cstring>","expires_at":"\u003cstring>","manual":true,"loyalty_tier":{"id":123,"name":"\u003cstring>","number":2,"default":true,"hidden":true,"lower_bound":"\u003cstring>","upper_bound":"\u003cstring>","position":1}},"tier_eligibility":{"kind":"points","valid_until":"2023-11-07T05:31:56Z","tier_points":{"now":123,"at_expiration":123},"points_needed_for_renewal":123,"points_needed_for_upgrade":123,"upgrade_tier":{"id":123,"name":"\u003cstring>","threshold":123},"forecasted_tier":{"id":123,"name":"\u003cstring>"}},"insights_segment":"At Risk","birthday":"\u003cstring>","referral_url":"\u003cstring>","receipt_upload_url":"\u003cstring>","loyalty_pass_url":"\u003cstring>","loyalty_pass_installed":true,"created_at":"\u003cstring>","updated_at":"\u003cstring>","linked_merchant_ids":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"bdb9c641-0278-416f-a897-0742256a58bb":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.details.additionalProperties","typeLabel":"string"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"601d164b-abea-4588-b1bd-dfdce598cb0c":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","uniqueKey":"error.code","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"error.details.additionalProperties","typeLabel":"string"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"b363c587-1787-4d43-bc3e-bd6b4f95bc7e":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","uniqueKey":"error.code","typeLabel":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","uniqueKey":"error.details.additionalProperties","typeLabel":"string"},"uniqueKey":"error.details","typeLabel":"object"}},"required":["message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"65aabd7b-e90d-4d93-b730-6ea4019c6f1a":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4e315c9c-a04d-4d32-9d6b-3d3cab85c7ac":{"ProgramApiKey":{"type":"http","scheme":"bearer","description":"An API key linked to a Program in LoyaltyLion, with a set of permissions (scopes). API keys can be created manually, or acquired through an OAuth2 flow. The API key should be provided as a `Bearer` token in the `Authorization` header","scopes":["write_customers"],"schemeName":"ProgramApiKey"}},"6cf9448e-46b2-46cd-8017-dc1fb5881bb5":{"SiteTokenSecret":{"type":"http","scheme":"basic","description":"[DEPRECATED] Authenticate using a LoyaltyLion site's `token` as username, and its `secret` as the password. This authentication method is deprecated and will be removed in future. Use the `ProgramApiKey` authentication method instead","scopes":[],"schemeName":"SiteTokenSecret"}}},"servers":{"a8460179-01e1-40c9-803d-13bf195187d2":{"url":"https://api.loyaltylion.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key linked to a Program in LoyaltyLion, with a set of permissions (scopes). API keys can be created manually, or acquired through an OAuth2 flow. The API key should be provided as a `Bearer` token in the `Authorization` header","scopes":["write_customers"],"schemeName":"ProgramApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key linked to a Program in LoyaltyLion, with a set of permissions (scopes). API keys can be created manually, or acquired through an OAuth2 flow. The API key should be provided as a `Bearer` token in the `Authorization` header","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ProgramApiKey","name":"Authorization"}],"title":"ProgramApiKey"},{"schemes":[{"scheme":{"type":"http","scheme":"basic","description":"[DEPRECATED] Authenticate using a LoyaltyLion site's `token` as username, and its `secret` as the password. This authentication method is deprecated and will be removed in future. Use the `ProgramApiKey` authentication method instead","scopes":[],"schemeName":"SiteTokenSecret"},"schema":{"title":"Basic Auth","type":"object","description":"[DEPRECATED] Authenticate using a LoyaltyLion site's `token` as username, and its `secret` as the password. This authentication method is deprecated and will be removed in future. Use the `ProgramApiKey` authentication method instead","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"SiteTokenSecret","name":"Authorization"}],"title":"SiteTokenSecret"}]},"originalFileLocation":"api-reference/v2/openapi.json"},"subdomain":"loyaltylion","siteName":"LoyaltyLion","title":"Update Customer - LoyaltyLion","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference/v2/resources/customers/update-customer","matchLevel":0},"2025-06":{"href":"/headless-api/introduction","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-10-31T16:10:27.562Z","originalFileLocation":"api-reference/v2/resources/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=\"application-name\" content=\"LoyaltyLion\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update Customer - LoyaltyLion\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LoyaltyLion\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://loyaltylion.mintlify.site/_mintlify/api/og/v2?division=Customers\u0026amp;title=Update+Customer\u0026amp;theme=876105ba0b4007d402979f34\u0026amp;signature=9d88fcd3e218042b79393119227a5f0a04be591e345e4e917fd175bb1301adef\">\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 - LoyaltyLion\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://loyaltylion.mintlify.site/_mintlify/api/og/v2?division=Customers\u0026amp;title=Update+Customer\u0026amp;theme=876105ba0b4007d402979f34\u0026amp;signature=9d88fcd3e218042b79393119227a5f0a04be591e345e4e917fd175bb1301adef\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/loyaltylion/-HHkKRQ0-0oU9Wqj/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LoyaltyLion\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7533f2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2/resources/customers/update-customer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.loyaltylion.com/#organization\",\"name\":\"LoyaltyLion\",\"url\":\"https://developers.loyaltylion.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/loyaltylion/qoWgzO-fbs5_an5D/logo/loyaltylion-logo-black.svg?fit=max\u0026auto=format\u0026n=qoWgzO-fbs5_an5D\u0026q=85\u0026s=a8042001d5f93ef344ce190752bfba7d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.loyaltylion.com#website\",\"name\":\"LoyaltyLion\",\"url\":\"https://developers.loyaltylion.com\",\"publisher\":{\"@id\":\"https://developers.loyaltylion.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer#webpage\",\"url\":\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer\",\"name\":\"Update Customer\",\"dateModified\":\"2026-10-31T16:10:27.562Z\",\"isPartOf\":{\"@id\":\"https://developers.loyaltylion.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Resources\",\"item\":\"https://developers.loyaltylion.com/api-reference/v2/resources/whoami\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Customers\",\"item\":\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/list-customers\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update Customer\",\"item\":\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer#apireference\",\"headline\":\"Update Customer\",\"name\":\"Update Customer\",\"url\":\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer\",\"mainEntityOfPage\":{\"@id\":\"https://developers.loyaltylion.com/api-reference/v2/resources/customers/update-customer#webpage\"},\"dateModified\":\"2026-10-31T16:10:27.562Z\",\"publisher\":{\"@id\":\"https://developers.loyaltylion.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.loyaltylion.com#website\"}}]}\u003c/script>","agentPointerHref":"/api-reference/v2/resources/customers/update-customer.md","siteName":"LoyaltyLion","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/introduction"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/overview"}]},{"tab":"Admin API","versions":[{"version":"v2","default":true,"groups":[{"group":"Admin API","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"group":"Authentication","pages":[{"title":"Overview","href":"/api-reference/authentication/overview"},{"title":"API keys","href":"/api-reference/authentication/api-keys"},{"title":"OAuth","href":"/api-reference/authentication/oauth"},{"title":"Token \u0026 secret (deprecated)","href":"/api-reference/authentication/token-secret"}]},{"title":"Pagination","href":"/api-reference/pagination"}]},{"group":"Resources","pages":[{"group":"Identity","pages":[{"title":"Who Am I","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/identity/whoami","href":"/api-reference/v2/resources/whoami"}]},{"group":"Customers","pages":[{"title":"List Customers","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/customers","description":null,"href":"/api-reference/v2/resources/customers/list-customers"},{"title":"Update Customer","version":"v2","openapi":"api-reference/v2/openapi.json PATCH /v2/customers/{merchant_id}","href":"/api-reference/v2/resources/customers/update-customer"},{"title":"Add Points","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/customers/{merchant_id}/points","description":null,"href":"/api-reference/v2/resources/customers/add-points"},{"title":"Remove Points","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/customers/{merchant_id}/remove_points","href":"/api-reference/v2/resources/customers/remove-points"},{"title":"List Available Rewards","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/customers/{merchant_id}/available_rewards","href":"/api-reference/v2/resources/customers/rewards/list-available-rewards"},{"title":"Redeem Reward","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/customers/{merchant_id}/claimed_rewards","href":"/api-reference/v2/resources/customers/rewards/redeem-reward"},{"title":"Refund Reward","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/customers/{merchant_id}/claimed_rewards/{claimed_reward_id}/refund","href":"/api-reference/v2/resources/customers/rewards/refund-reward"},{"title":"List Transactions","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/customers/{merchant_id}/transactions","href":"/api-reference/v2/resources/customers/list-transactions"}]},{"group":"Activities","pages":[{"title":"List Activities","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/activities","href":"/api-reference/v2/resources/activities/list-activities"},{"title":"Create Activity","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/activities","href":"/api-reference/v2/resources/activities/create-activity"},{"title":"Update Activity","version":"v2","openapi":"api-reference/v2/openapi.json PUT /v2/activities/{name}/{merchant_id}","href":"/api-reference/v2/resources/activities/update-activity"}]},{"group":"Transactions","pages":[{"title":"List Transactions","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/transactions","href":"/api-reference/v2/resources/transactions/list-transactions"}]},{"group":"Orders","pages":[{"title":"List Orders","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/orders","href":"/api-reference/v2/resources/orders/list-orders"},{"title":"Get Order","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/orders/{merchant_id}","href":"/api-reference/v2/resources/orders/get-order"},{"title":"Create Order","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/orders","href":"/api-reference/v2/resources/orders/create-order"},{"title":"Update Order","version":"v2","openapi":"api-reference/v2/openapi.json PUT /v2/orders/{merchant_id}","href":"/api-reference/v2/resources/orders/update-order"}]},{"group":"Sites","pages":[{"title":"List Sites","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/sites","href":"/api-reference/v2/resources/sites/list-sites"},{"title":"Create WebView Session","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/sites/{site_id}/webviews/sessions","href":"/api-reference/v2/resources/sites/create-webview-session"}]},{"group":"Reviews","pages":[{"title":"Create Review","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/reviews/{platform}","href":"/api-reference/v2/resources/reviews/create-review"},{"title":"Update Review","version":"v2","openapi":"api-reference/v2/openapi.json PUT /v2/reviews/{platform}/{merchant_id}","href":"/api-reference/v2/resources/reviews/update-review"},{"title":"Delete Review","version":"v2","openapi":"api-reference/v2/openapi.json DELETE /v2/reviews/{platform}/{merchant_id}","href":"/api-reference/v2/resources/reviews/delete-review"}]},{"group":"Rewards","pages":[{"title":"Enable Reward","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/rewards/{reward_id}/enable","href":"/api-reference/v2/resources/rewards/enable-reward"},{"title":"Disable Reward","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/rewards/{reward_id}/disable","href":"/api-reference/v2/resources/rewards/disable-reward"}]},{"group":"Emails","pages":[{"title":"List Unsubscribes","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/loyalty_emails/unsubscribes","href":"/api-reference/v2/resources/emails/list-unsubscribes"},{"title":"Create Unsubscribe","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/loyalty_emails/unsubscribes","href":"/api-reference/v2/resources/emails/create-unsubscribe"}]},{"group":"Exports","pages":[{"title":"Customer exports","version":"v2","href":"/api-reference/v2/resources/customers/exports/overview"},{"title":"Create Export","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/customers/exports","href":"/api-reference/v2/resources/customers/exports/create-export"},{"title":"Get Export","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/customers/exports/{id}","href":"/api-reference/v2/resources/customers/exports/get-export"},{"title":"List Exports","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/customers/exports","href":"/api-reference/v2/resources/customers/exports/list-exports"}]},{"group":"Webhooks","pages":[{"title":"List Webhooks","version":"v2","openapi":"api-reference/v2/openapi.json GET /v2/webhooks","href":"/api-reference/v2/resources/webhooks/list-webhooks"},{"title":"Create Webhook","version":"v2","openapi":"api-reference/v2/openapi.json POST /v2/webhooks","href":"/api-reference/v2/resources/webhooks/create-webhook"},{"title":"Delete Webhook","version":"v2","openapi":"api-reference/v2/openapi.json DELETE /v2/webhooks/{webhook_id}","href":"/api-reference/v2/resources/webhooks/delete-webhook"}]}]},{"group":"Webhooks","pages":[{"title":"Introduction","href":"/api-reference/v2/webhooks/overview"},{"group":"Webhook events","pages":[{"title":"customers/update","href":"/api-reference/v2/webhooks/events/customers-update"},{"title":"loyalty_emails/unsubscribe","href":"/api-reference/v2/webhooks/events/loyalty-emails-unsubscribe"},{"title":"rewards/store_fulfilment","href":"/api-reference/v2/webhooks/events/rewards-store-fulfilment"},{"title":"receipts/manual_approval_required","href":"/api-reference/v2/webhooks/events/receipts-manual-approval-required"},{"title":"program_events/customer.enrolled","href":"/api-reference/v2/webhooks/events/program-events/customer-enrolled"},{"title":"program_events/customer.tier_upgraded","href":"/api-reference/v2/webhooks/events/program-events/customer-tier-upgraded"},{"title":"program_events/customer.tier_downgraded","href":"/api-reference/v2/webhooks/events/program-events/customer-tier-downgraded"},{"title":"program_events/customer.reward_available_notification","href":"/api-reference/v2/webhooks/events/program-events/customer-reward-available-notification"},{"title":"program_events/customer.recurring_reward_available_reminder","href":"/api-reference/v2/webhooks/events/program-events/customer-recurring-reward-available-reminder"},{"title":"program_events/customer.claimed_reward","href":"/api-reference/v2/webhooks/events/program-events/customer-claimed-reward"},{"title":"program_events/customer.points_earned","href":"/api-reference/v2/webhooks/events/program-events/customer-points-earned"},{"title":"program_events/customer.referral_complete","href":"/api-reference/v2/webhooks/events/program-events/customer-referral-complete"},{"title":"program_events/customer.rule_completed","href":"/api-reference/v2/webhooks/events/program-events/customer-rule-completed"},{"title":"program_events/customer.approaching_tier_upgrade","href":"/api-reference/v2/webhooks/events/program-events/customers-approaching-tier-upgrade"},{"title":"program_events/customer.moved_to_defected_segment","href":"/api-reference/v2/webhooks/events/program-events/customer-moved-to-defected-segment"},{"title":"program_events/customer.moved_to_loyal_segment","href":"/api-reference/v2/webhooks/events/program-events/customer-moved-to-loyal-segment"},{"title":"program_events/customer.moved_to_at_risk_segment","href":"/api-reference/v2/webhooks/events/program-events/customer-moved-to-at-risk-segment"},{"title":"program_events/customer.approaching_points_expiration","href":"/api-reference/v2/webhooks/events/program-events/customer-approaching-points-expiration"},{"title":"program_events/customer.approaching_reward_expiration","href":"/api-reference/v2/webhooks/events/program-events/customer-approaching-reward-expiration"},{"title":"program_events/customer.receipt_approved","href":"/api-reference/v2/webhooks/events/program-events/customer-receipt-approved"},{"title":"program_events/customer.receipt_declined","href":"/api-reference/v2/webhooks/events/program-events/customer-receipt-declined"}]}]}]}]},{"tab":"Headless API","versions":[{"version":"2025-06","default":true,"groups":[{"group":"Headless API","pages":[{"title":"Introduction","href":"/headless-api/introduction"},{"title":"Customer session tokens","href":"/headless-api/session-tokens"},{"title":"Errors","href":"/headless-api/errors"},{"title":"Changelog","href":"/headless-api/changelog"}]},{"group":"Guides","pages":[{"title":"Referrals","href":"/headless-api/guides/referrals"},{"group":"Shopify Hydrogen","pages":[{"title":"Integrate with Hydrogen","href":"/headless-api/guides/hydrogen/integrate"},{"title":"Free product rewards","href":"/headless-api/guides/hydrogen/free-product-rewards"}]}]},{"group":"Resources","pages":[{"group":"Configuration","pages":[{"title":"Get Configuration","version":"v2","openapi":"headless-api/2025-06/openapi.json GET /headless/2025-06/{site_id}/configuration","href":"/headless-api/2025-06/configuration/get-configuration"}]},{"group":"Customers","pages":[{"title":"Get Customer","version":"v2","openapi":"headless-api/2025-06/openapi.json GET /headless/2025-06/{site_id}/customers/{merchant_id}","href":"/headless-api/2025-06/customers/get-customer"},{"title":"Initialize Session","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/customers/{merchant_id}/sessions","href":"/headless-api/2025-06/customers/initialize-session"},{"title":"Enroll Customer","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/customers/{merchant_id}/enroll","href":"/headless-api/2025-06/customers/enroll-customer"},{"title":"Set Birthday","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/customers/{merchant_id}/birthday","href":"/headless-api/2025-06/customers/set-birthday"},{"title":"Subscribe to Email Marketing","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/customers/{merchant_id}/email_marketing/subscribe","href":"/headless-api/2025-06/customers/subscribe-email-marketing"}]},{"group":"Referrals","pages":[{"title":"Claim Referee Incentive","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/referrals/referee_incentive","href":"/headless-api/2025-06/referrals/claim-referee-incentive"},{"title":"Track Share","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/referrals/shares","href":"/headless-api/2025-06/referrals/track-share"},{"title":"Register Guest Referrer","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/referrals/guest_registrations","href":"/headless-api/2025-06/referrals/register-guest-referrer"}]},{"group":"Reward redemption","pages":[{"title":"Cart Discount Voucher","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rewards/cart_discount_voucher/redeem","href":"/headless-api/2025-06/reward-redemption/cart-discount-voucher"},{"title":"Free Shipping Voucher","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rewards/free_shipping_voucher/redeem","href":"/headless-api/2025-06/reward-redemption/free-shipping-voucher"},{"title":"Collection Discount Voucher","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rewards/collection_discount_voucher/redeem","href":"/headless-api/2025-06/reward-redemption/collection-discount-voucher"},{"title":"Product Discount Voucher","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rewards/product_discount_voucher/redeem","href":"/headless-api/2025-06/reward-redemption/product-discount-voucher"},{"title":"Gift Card","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rewards/gift_card/redeem","href":"/headless-api/2025-06/reward-redemption/gift-card"},{"title":"Active Subscription Discount Voucher","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rewards/active_subscription_discount_voucher/redeem","href":"/headless-api/2025-06/reward-redemption/active-subscription-discount-voucher"},{"title":"Active Subscription Product","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rewards/active_subscription_product/redeem","href":"/headless-api/2025-06/reward-redemption/active-subscription-product"},{"title":"Free Product","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rewards/product_cart/redeem","href":"/headless-api/2025-06/reward-redemption/free-product"}]},{"group":"Reward refunds","pages":[{"title":"Free Product","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rewards/product_cart/refund","href":"/headless-api/2025-06/reward-refund/free-product"}]},{"group":"Complete rules","pages":[{"title":"Clickthrough","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rules/clickthrough/complete","href":"/headless-api/2025-06/complete-rules/clickthrough"},{"title":"Facebook Like","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rules/facebook_like/complete","href":"/headless-api/2025-06/complete-rules/facebook-like"},{"title":"Instagram Follow","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rules/instagram_follow/complete","href":"/headless-api/2025-06/complete-rules/instagram-follow"},{"title":"TikTok Follow","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rules/tiktok_follow/complete","href":"/headless-api/2025-06/complete-rules/tiktok-follow"},{"title":"Twitter/X Follow","version":"v2","openapi":"headless-api/2025-06/openapi.json POST /headless/2025-06/{site_id}/rules/twitter_follow/complete","href":"/headless-api/2025-06/complete-rules/twitter-follow"}]}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/docs/mcp/overview"}]}]},"basePath":"","title":"Update Customer - LoyaltyLion","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}