Customer

A customer of the shop. Carries identity and contact details, the assigned customer group and sales channel, and the customer's order history.

type Customer implements Node {
  id: ID!
  accountType: CustomerAccountType!
  active: Boolean
  company: String
  createdAt: DateTime!
  customerNumber: String!
  email: String!
  firstName: String!
  groupId: ID!
  guest: Boolean
  lastName: String!
  salesChannelId: ID!
  shopifyId: String
  title: String
  updatedAt: DateTime
  vatIds: JSON
  boundSalesChannel: SalesChannel
  defaultPaymentMethod: PaymentMethod
  group: CustomerGroup
  lastPaymentMethod: PaymentMethod
  orders(
    first: Int = 10
    after: String
  ): OrderConnection
  requestedGroup: CustomerGroup
  salesChannel: SalesChannel
  salutation: Salutation
  tags(
    first: Int = 10
    after: String
    filter: TagFilterInput
  ): TagConnection
}

Fields

Customer.id ● ID! non-null scalar

Global identifier for this entity.

Customer.accountType ● CustomerAccountType! non-null enum

Customer type. Either Private or Business.

Customer.active ● Boolean scalar

Whether the customer account is active.

Customer.company ● String scalar

Company name. Set for business customers.

Customer.createdAt ● DateTime! non-null scalar

Timestamp the customer was created.

Customer.customerNumber ● String! non-null scalar

Human-readable customer number assigned at registration.

Customer.email ● String! non-null scalar

Customer's email address. Unique per sales channel and bound-sales-channel scope.

Customer.firstName ● String! non-null scalar

Customer's first name.

Customer.groupId ● ID! non-null scalar

ID of the customer group the customer is assigned to.

Customer.guest ● Boolean scalar

Whether this is a guest account (created during guest checkout, no login).

Customer.lastName ● String! non-null scalar

Customer's last name.

Customer.salesChannelId ● ID! non-null scalar

ID of the sales channel the customer registered in.

Customer.shopifyId ● String scalar

Shopify GID of the customer, e.g. gid://shopify/Customer/3123. Null for a customer that was not imported from Shopify.

Customer.title ● String scalar

Optional academic or honorific title (e.g. Dr.).

Customer.updatedAt ● DateTime scalar

Timestamp of the last update to the customer.

Customer.vatIds ● JSON scalar

List of VAT registration IDs of the customer, as a JSON array of strings.

Customer.boundSalesChannel ● SalesChannel object

Customer.defaultPaymentMethod ● PaymentMethod object

Customer.group ● CustomerGroup object

Customer.lastPaymentMethod ● PaymentMethod object

Customer.orders ● OrderConnection object

Customer.orders.first ● Int scalar

Customer.orders.after ● String scalar

Customer.requestedGroup ● CustomerGroup object

Customer.salesChannel ● SalesChannel object

Customer.salutation ● Salutation object

Customer.tags ● TagConnection object

Customer.tags.first ● Int scalar

Customer.tags.after ● String scalar

Customer.tags.filter ● TagFilterInput input

Interfaces

Node interface

Any entity that can be loaded by its global id through the node(id: ID!) query.

Returned By

createCustomer mutation ● customer query

Member Of

CustomerEdge object ● GoodsReceipt object ● Quote object