Skip to main content

User

Represents user account data.

type User implements Node, ObjectWithMetadata {
id: ID!
metadata: [MetadataItem!]!
privateMetadata: [MetadataItem!]!
email: String!
firstName: String!
lastName: String!
companyName: String!
isActive: Boolean!
dateJoined: DateTime!
lastLogin: DateTime
lastStatusChangedAt: DateTime
personalPhone: String
externalId: String
externalSource: String
taxExemptCode: String
vatIdentificationNumber: String
externalPayoutAccountId: String
externalPayoutOnboardingUrl: String
defaultShippingAddress: Address
defaultBillingAddress: Address
externalInventoryId: String
isStaff: Boolean!
note: String
externalPayoutSource: UserExternalPayoutSource
addresses: [Address!]!
isAssignable: Boolean!
tenantId: String
avatar(
size: Int
): Image
checkout: Checkout
numOrders: Int
orderCount: Int
orderTotalAmount: Money
isMarketplaceOperator: Boolean!
orders(
filter: CustomerOrderFilterInput
sortBy: OrderSortingInput
before: String
after: String
first: Int
last: Int
): OrderCountableConnection!
nauticalOrders(
filter: CustomerNauticalOrderFilterInput
sortBy: OrderSortingInput
before: String
after: String
first: Int
last: Int
): NauticalOrderCountableConnection!
userPermissions: [UserPermission!]!
permissionGroups: [Group!]!
editableGroups: [Group!]!
events: [CustomerEvent!]!
timeline(
kinds: [TimelineEntryKind!]
): [TimelineEntry!]!
storedPaymentSources: [PaymentSource!]!
seller: Seller
wishlist(
before: String
after: String
first: Int
last: Int
): WishlistItemCountableConnection!
wishlists(
before: String
after: String
first: Int
last: Int
): WishlistCountableConnection!
documents: [Document!]!
dashboardEmbeddingToken: String
customFields: [SelectedAttribute!]!
}
Show more ↓

Fields

User.id ● ID! non-null scalar

The Globally Unique ID of this object

User.metadata ● [MetadataItem!]! non-null object

List of public metadata items. Can be accessed without permissions.

User.privateMetadata ● [MetadataItem!]! non-null object

List of private metadata items. Requires proper staff permissions to access.

User.email ● String! non-null scalar

User.firstName ● String! non-null scalar

User.lastName ● String! non-null scalar

User.companyName ● String! non-null scalar

User.isActive ● Boolean! non-null scalar

User.dateJoined ● DateTime! non-null scalar

User.lastLogin ● DateTime scalar

User.lastStatusChangedAt ● DateTime scalar

User.personalPhone ● String scalar

User.externalId ● String scalar

User.externalSource ● String scalar

User.taxExemptCode ● String scalar

User.vatIdentificationNumber ● String scalar

User.externalPayoutAccountId ● String scalar

User.externalPayoutOnboardingUrl ● String scalar

User.defaultShippingAddress ● Address object

User's default shipping address

User.defaultBillingAddress ● Address object

User's default billing address

User.externalInventoryId ● String scalar

User.isStaff ● Boolean! non-null scalar

Whether the user is a staff member (MPO or seller)

User.note ● String scalar

A note about the customer.

User.externalPayoutSource ● UserExternalPayoutSource enum

External payout source for the user

User.addresses ● [Address!]! non-null object

List of all user's addresses

User.isAssignable ● Boolean! non-null scalar

Whether the user can be assigned as seller owner

User.tenantId ● String scalar

The user's tenant ID (UUID)

User.avatar ● Image object

User's avatar image

User.avatar.size ● Int scalar

User.checkout ● Checkout object

Returns the last open checkout of this user.

User.numOrders ● Int scalar

Number of orders placed by the user.

User.orderCount ● Int scalar

Total count of NauticalOrders for this customer in the filtered date range (from placedOrders filter).

User.orderTotalAmount ● Money object

Total gross amount of NauticalOrders for this customer in the filtered date range (from placedOrders filter).

User.isMarketplaceOperator ● Boolean! non-null scalar

Whether this user is a marketplace operator (MPO).

User.orders ● OrderCountableConnection! non-null object

List of user's orders.

User.orders.filter ● CustomerOrderFilterInput input
User.orders.sortBy ● OrderSortingInput input
User.orders.before ● String scalar

Returns the items in the list that come before the specified cursor.

User.orders.after ● String scalar

Returns the items in the list that come after the specified cursor.

User.orders.first ● Int scalar

Returns the first n items from the list.

User.orders.last ● Int scalar

Returns the items in the list that come after the specified cursor.

User.nauticalOrders ● NauticalOrderCountableConnection! non-null object

List of user's nautical (marketplace) orders.

User.nauticalOrders.filter ● CustomerNauticalOrderFilterInput input
User.nauticalOrders.sortBy ● OrderSortingInput input
User.nauticalOrders.before ● String scalar

Returns the items in the list that come before the specified cursor.

User.nauticalOrders.after ● String scalar

Returns the items in the list that come after the specified cursor.

User.nauticalOrders.first ● Int scalar

Returns the first n items from the list.

User.nauticalOrders.last ● Int scalar

Returns the items in the list that come after the specified cursor.

User.userPermissions ● [UserPermission!]! non-null object

List of user's permissions.

User.permissionGroups ● [Group!]! non-null object

List of user's permission groups.

User.editableGroups ● [Group!]! non-null object

List of user's permission groups which user can manage.

User.events ● [CustomerEvent!]! non-null object

List of events associated with the user.

User.timeline ● [TimelineEntry!]! non-null object

Unified change-history feed for this customer. Projects the legacy CustomerEvent log into a TimelineEntry list ordered most-recent-first, so customer history renders through the same dashboard component as the order, seller and product timelines. Note that CustomerEvent records the customer an event concerns, not who performed it, so entries report an unknown actor rather than attributing staff actions to the customer. Optional kinds argument filters server-side.

User.timeline.kinds ● [TimelineEntryKind!] list enum

User.storedPaymentSources ● [PaymentSource!]! non-null object

List of stored payment sources.

User.seller ● Seller object

The seller associated with this user.

User.wishlist ● WishlistItemCountableConnection! non-null object

Wishlist items of the user's default wishlist.

User.wishlist.before ● String scalar

Returns the items in the list that come before the specified cursor.

User.wishlist.after ● String scalar

Returns the items in the list that come after the specified cursor.

User.wishlist.first ● Int scalar

Returns the first n items from the list.

User.wishlist.last ● Int scalar

Returns the items in the list that come after the specified cursor.

User.wishlists ● WishlistCountableConnection! non-null object

All wishlists of the user.

User.wishlists.before ● String scalar

Returns the items in the list that come before the specified cursor.

User.wishlists.after ● String scalar

Returns the items in the list that come after the specified cursor.

User.wishlists.first ● Int scalar

Returns the first n items from the list.

User.wishlists.last ● Int scalar

Returns the items in the list that come after the specified cursor.

User.documents ● [Document!]! non-null object

List of documents associated with the user.

User.dashboardEmbeddingToken ● String scalar

Dashboard embedding token. If null, the environment isn't set or dashboard reporting is disabled.

User.customFields ● [SelectedAttribute!]! non-null object

List of custom fields assigned to this user.

Interfaces

Node interface

An object with a Globally Unique ID

ObjectWithMetadata interface

An object that supports metadata.

Returned By

me query ● user query ● userByEmail query

Member Of

AccountAddressCreate object ● AccountAddressDelete object ● AccountAddressSetDefault object ● AccountAddressUpdate object ● AccountConfirm object ● AccountDelete object ● AccountRegister object ● AccountRequestDeletion object ● AccountUpdate object ● AddressCreate object ● AddressDelete object ● AddressSetDefault object ● AddressUpdate object ● App object ● Checkout object ● Content object ● CustomerCreate object ● CustomerDelete object ● CustomerEvent object ● CustomerUpdate object ● EmailChangeConfirm object ● EmailChangeRequest object ● ExportEvent object ● ExportFile object ● Fulfillment object ● Group object ● ImportEvent object ● ImportFile object ● Ledger object ● NauticalOrder object ● NauticalOrderEvent object ● Order object ● OrderEvent object ● PasswordChange object ● PasswordRequestReset object ● PasswordSet object ● ProductStatusLog object ● Refund object ● Seller object ● SellerAgreementAcknowledge object ● SellerAgreementDecline object ● SellerEventType object ● SellerUserType object ● SSOLogin object ● StaffCreate object ● StaffDelete object ● StaffUpdate object ● StockEvent object ● TokenCreate object ● TokenCreateSSO object ● TokenRefresh object ● TokensDeactivateAll object ● TokenVerify object ● UserAvatarDelete object ● UserAvatarUpdate object ● UserCountableEdge object ● VendorPayoutEvent object ● Wishlist object

Implemented By

CustomFieldInstance union ● DocumentTargetInstance union ● Vendor union

Was this page helpful?