User

A User represents an actor who interacts with the platform and is identified by a unique email address.

User vs Account

The distinction between User and Account is important:

• A User is the authenticated identity (person / serviceAccount + credentials).
• An Account is the legal holding vehicle (individual, corporate, or joint).

A single user can have multiple accounts (e.g., a personal account and a company account). Conversely, a joint account involves two users sharing one account, or a corporate account can involve the CEO and accountant.

This relationship is somewhat similar to the one used in the intermediated placement thanks to the Advisors.

User Groups (Teams)

Users are organized into UserGroup. Each group defines a shared set of roles and permissions. Admins can assign users to different groups to fine-tune their access rights.

query {
  GetUser(id: "456") {
    id
    active
    email
    firstName
    lastName
    userGroup {
      id
      name
      persona
    }
    accounts {
      id
      label
    }
    # ...Other User fields
  }
}

→ Type reference: User

User Lifecycle

State	Description
Pending	User has registered but is awaiting admin approval (acceptedAt is null)
Active	User is approved and can log in (active: true)
Inactive	User has been deactivated (active: false); an unactiveComment explains why

Key Fields at a Glance

Field	Type	Description
id	ID	Unique identifier
email	String!	Email address (used for login)
firstName	String	First name
lastName	String	Last name
mobile	String	Mobile phone number
active	Boolean	Whether the user is active
acceptedAt	DateTime	When the user was accepted (null = pending)
userGroup	UserGroup	The team / permission group
accounts	[Account]!	All accounts owned by this user
locale	SupportedLocale	Preferred language locale
lastLogin	DateTime	Timestamp of the last successful login

Related Queries & Mutations

Operation	Reference
Fetch a single user	GetUser
List all users	GetUsers
Create a user (authenticated)	CreateUser
Create a user (public / self-registration)	CreateUser (public)
Activate a user	ActivateUser
Deactivate a user	DeactivateUser
Update user info and permissions	UpdateUserInfosAndPermissions