Customer - customer - OBJECT

Version: 2025-01

Description:

Represents the personal information of a customer. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

Access Scopes

Fields

  • creationDate: DateTime! - The date and time when the customer was created.
  • defaultAddress: CustomerAddress - The default address of the customer.
  • displayName: String! - The full name of the customer, based on the first_name and last_name values. If these aren't available, it falls back to the customer's email address, and if that isn't available, the customer's phone number.
  • emailAddress: CustomerEmailAddress - The email address of the customer.
  • firstName: String - The first name of the customer.
  • id: ID! - A globally-unique ID.
  • imageUrl: URL! - The URL to the avatar image of the customer.
  • lastIncompleteCheckout: Checkout - The customer's most recently updated, incomplete checkout.
  • lastName: String - The last name of the customer.
  • metafield: Metafield - A metafield found by namespace and key.
  • metafields: Metafield! - The metafields associated with the resource matching the supplied list of namespaces and keys.
  • phoneNumber: CustomerPhoneNumber - The phone number of the customer.
  • subscriptionContract: SubscriptionContract - A Subscription Contract resource identified by ID.
  • tags: String! - A comma-separated list of tags that have been added to the customer.

Connections

  • addresses: CustomerAddressConnection!
  • companyContacts: CompanyContactConnection!
  • draftOrders: DraftOrderConnection!
  • orders: OrderConnection!
  • storeCreditAccounts: StoreCreditAccountConnection!
  • subscriptionContracts: SubscriptionContractConnection!

Related queries

  • customer Returns the Customer resource. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

Related mutations

  • customerUpdate Updates the customer's personal information.

Related Unions

  • PurchasingEntity Represents information about the purchasing entity for the order or draft order.

Examples