Customer

Required access

unauthenticated_read_customers access scope

A customer represents a customer account with the shop. Customer accounts store contact information for the customer, saving logged-in customers the trouble of having to provide it at every checkout.

Show definition
# A customer represents a customer account with the shop. Customer accounts store
# contact information for the customer, saving logged-in customers the trouble of
# having to provide it at every checkout.
type Customer {
  # Indicates whether the customer has consented to be sent marketing material via email.
  acceptsMarketing: Boolean!

  # A list of addresses for the customer.
  addresses(
    # Returns up to the first `n` elements from the list.
    first: Int

    # Returns the elements that come after the specified cursor.
    after: String

    # Returns up to the last `n` elements from the list.
    last: Int

    # Returns the elements that come before the specified cursor.
    before: String

    # Reverse the order of the underlying list.
    reverse: Boolean = false
  ): MailingAddressConnection!

  # The date and time when the customer was created.
  createdAt: DateTime!

  # The customer’s default address.
  defaultAddress: MailingAddress

  # The customer’s name, email or phone number.
  displayName: String!

  # The customer’s email address.
  email: String

  # The customer’s first name.
  firstName: String

  # A unique identifier for the customer.
  id: ID!

  # The customer’s last name.
  lastName: String

  # The orders associated with the customer.
  orders(
    # Returns up to the first `n` elements from the list.
    first: Int

    # Returns the elements that come after the specified cursor.
    after: String

    # Returns up to the last `n` elements from the list.
    last: Int

    # Returns the elements that come before the specified cursor.
    before: String

    # Reverse the order of the underlying list.
    reverse: Boolean = false

    # Sort the underlying list by the given key.
    sortKey: OrderSortKeys = ID

    # Supported filter parameters:
    #  - `processed_at`
    query: String
  ): OrderConnection!

  # The customer’s phone number.
  phone: String

  # The date and time when the customer information was updated.
  updatedAt: DateTime!
}

Connections

addresses   (MailingAddressConnection!)

A list of addresses for the customer.

Required access

unauthenticated_read_ access scope

Argument Type Default Description
after

String

Returns the elements that come after the specified cursor.

before

String

Returns the elements that come before the specified cursor.

first

Int

Returns up to the first n elements from the list.

last

Int

Returns up to the last n elements from the list.

reverse

Boolean

false

Reverse the order of the underlying list.

orders   (OrderConnection!)

The orders associated with the customer.

Required access

unauthenticated_read_ access scope

Argument Type Default Description
after

String

Returns the elements that come after the specified cursor.

before

String

Returns the elements that come before the specified cursor.

first

Int

Returns up to the first n elements from the list.

last

Int

Returns up to the last n elements from the list.

query

String

Supported filter parameters:

  • processed_at

reverse

Boolean

false

Reverse the order of the underlying list.

sortKey

OrderSortKeys

ID

Sort the underlying list by the given key.

Fields

acceptsMarketing   (Boolean!)

Indicates whether the customer has consented to be sent marketing material via email.

Required access

unauthenticated_read_ access scope

createdAt   (DateTime!)

The date and time when the customer was created.

Required access

unauthenticated_read_ access scope

defaultAddress   (MailingAddress)

The customer’s default address.

Required access

unauthenticated_read_ access scope

displayName   (String!)

The customer’s name, email or phone number.

Required access

unauthenticated_read_ access scope

email   (String)

The customer’s email address.

Required access

unauthenticated_read_ access scope

firstName   (String)

The customer’s first name.

Required access

unauthenticated_read_ access scope

id   (ID!)

A unique identifier for the customer.

Required access

unauthenticated_read_ access scope

lastName   (String)

The customer’s last name.

Required access

unauthenticated_read_ access scope

phone   (String)

The customer’s phone number.

Required access

unauthenticated_read_ access scope

updatedAt   (DateTime!)

The date and time when the customer information was updated.

Required access

unauthenticated_read_ access scope

Sign up for a Partner account to get started.

Sign up