--- title: Customer - GraphQL Admin description: >- Information about a customer of the shop, such as the customer's contact details, purchase history, and marketing preferences. Tracks the customer's total spending through the [`amountSpent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-amountSpent) field and provides access to associated data such as payment methods and subscription contracts. > Caution: > Only use this data if it's required for your app's functionality. Shopify will restrict [access to scopes](https://shopify.dev/api/usage/access-scopes) for apps that don't have a legitimate use for the associated data. api_version: 2026-01 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer' md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer.md' --- # Customer object Requires `read_customers` access scope. Information about a customer of the shop, such as the customer's contact details, purchase history, and marketing preferences. Tracks the customer's total spending through the [`amountSpent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-amountSpent) field and provides access to associated data such as payment methods and subscription contracts. *** Caution Only use this data if it's required for your app's functionality. Shopify will restrict [access to scopes](https://shopify.dev/api/usage/access-scopes) for apps that don't have a legitimate use for the associated data. *** ## Fields * addressesV2 * amountSpent * canDelete * companyContactProfiles * createdAt * dataSaleOptOut * defaultAddress * defaultEmailAddress * defaultPhoneNumber * displayName * events * firstName * id * image * lastName * lastOrder * legacyResourceId * lifetimeDuration * locale * mergeable * metafield * metafields * multipassIdentifier * note * numberOfOrders * orders * paymentMethods * productSubscriberStatus * state * statistics * storeCreditAccounts * subscriptionContracts * tags * taxExempt * taxExemptions * updatedAt * verifiedEmail ### Deprecated fields * addresses: deprecated * email: deprecated * emailMarketingConsent: deprecated * hasTimelineComment: deprecated * market: deprecated * metafieldDefinitions: deprecated * phone: deprecated * smsMarketingConsent: deprecated * unsubscribeUrl: deprecated * validEmailAddress: deprecated *** ## Map ### Fields and connections with this object * [AbandonedCheckout.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/AbandonedCheckout#field-AbandonedCheckout.fields.customer) * [Abandonment.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Abandonment#field-Abandonment.fields.customer) * [CalculatedDraftOrder.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/CalculatedDraftOrder#field-CalculatedDraftOrder.fields.customer) * [CompanyContact.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyContact#field-CompanyContact.fields.customer) * [CustomerConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/CustomerConnection#returns-nodes) * [CustomerEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEdge#field-CustomerEdge.fields.node) * [CustomerPaymentMethod.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPaymentMethod#field-CustomerPaymentMethod.fields.customer) * [DiscountCustomers.customers](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCustomers#field-DiscountCustomers.fields.customers) * [DraftOrder.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.customer) * [GiftCard.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard#field-GiftCard.fields.customer) * [GiftCardRecipient.recipient](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardRecipient#field-GiftCardRecipient.fields.recipient) * [Order.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.customer) * [PriceRuleCustomerSelection.customers](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceRuleCustomerSelection#field-PriceRuleCustomerSelection.fields.customers) * [SubscriptionBillingCycleEditedContract.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycleEditedContract#field-SubscriptionBillingCycleEditedContract.fields.customer) * [SubscriptionContract.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract#field-SubscriptionContract.fields.customer) * [SubscriptionContractBase.customer](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/SubscriptionContractBase#fields-customer) * [SubscriptionDraft.customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDraft#field-SubscriptionDraft.fields.customer) ### Possible type in * [Comment​Event​Embed](https://shopify.dev/docs/api/admin-graphql/latest/unions/CommentEventEmbed) * [Metafield​Reference](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReference) * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer) * [Purchasing​Entity](https://shopify.dev/docs/api/admin-graphql/latest/unions/PurchasingEntity) *** ## Queries * customer * customerByIdentifier * customers *** ## Customer Queries ### Queried by * [customer](https://shopify.dev/docs/api/admin-graphql/latest/queries/customer) * [customer​By​Identifier](https://shopify.dev/docs/api/admin-graphql/latest/queries/customerByIdentifier) * [customers](https://shopify.dev/docs/api/admin-graphql/latest/queries/customers) *** ## Mutations * customerAddTaxExemptions * customerCreate * customerEmailMarketingConsentUpdate * customerPaymentMethodSendUpdateEmail * customerRemoveTaxExemptions * customerReplaceTaxExemptions * customerSendAccountInviteEmail * customerSet * customerSmsMarketingConsentUpdate * customerUpdate * customerUpdateDefaultAddress *** ## Customer Mutations ### Mutated by * [customer​Add​Tax​Exemptions](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerAddTaxExemptions) * [customer​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerCreate) * [customer​Email​Marketing​Consent​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerEmailMarketingConsentUpdate) * [customer​Payment​Method​Send​Update​Email](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerPaymentMethodSendUpdateEmail) * [customer​Remove​Tax​Exemptions](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerRemoveTaxExemptions) * [customer​Replace​Tax​Exemptions](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerReplaceTaxExemptions) * [customer​Send​Account​Invite​Email](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerSendAccountInviteEmail) * [customer​Set](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerSet) * [customer​Sms​Marketing​Consent​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerSmsMarketingConsentUpdate) * [customer​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdate) * [customer​Update​Default​Address](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdateDefaultAddress) *** ## Interfaces * CommentEventSubject * HasEvents * HasMetafieldDefinitions * HasMetafields * HasStoreCreditAccounts * LegacyInteroperability * Node *** ## Customer Implements ### Implements * [Comment​Event​Subject](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CommentEventSubject) * [Has​Events](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasEvents) * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions) * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) * [Has​Store​Credit​Accounts](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasStoreCreditAccounts) * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/LegacyInteroperability) * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)