User

A User represents a Legalesign account holder. Users belong to Organisations and access Groups through GroupMember records. Each user has their own webhooks, signature images, and support tickets.

info

The user query is a special case — if you omit the id argument, it returns the currently authenticated user. All other types require an explicit ID.

Fields

Field	Type	Description
id	ID!	Unique identifier
name	String!	Full name
firstName	String	First name
lastName	String	Last name
email	String!	Email address
timeZone	String	Preferred timezone
companySize	String	Company size
companyRole	String	Role in their company
companyType	String	Type of company
settings	AWSJSON	Advanced settings including MFA and status
lastDocumentSentAt	AWSDateTime	Last document sent (any group)
lastValidTemplateMadeAt	AWSDateTime	Last valid template created (any group)
uploadedTemplatesCount	Int	Number of templates uploaded
webhookHmacSecret	String	Secret for signing webhooks
signatureImage	String	Short-lease URL to signature image (deprecated)
signatureImage1	String	Short-lease URL to signature image
signatureImage2	String	Short-lease URL to alternative signature image

Relationships

Field	Type	Description
consents	[Consent]	User consent records
session	Session	Session data (pinned items, tutorial state)
webhooks	[Webhook]	Webhooks configured by this user
authenticationEvents	[AuthenticationEvent]	Login history

Connections

organisationConnection

Organisations this user belongs to. Returns OrganisationConnection with organisation-level permissions on each edge.

memberConnection

Group memberships with permissions.

Argument	Type	Description
first	Int	Number of items
after	ID	Pagination cursor

supportTicketConnection

Support tickets for this user.

Argument	Type	Description
page	Int	Page number
organisationOrGroupId	ID	Filter by org or group (null = own tickets)

Query

# Get the current user
query GetMyUser {
  user {
    id
    firstName
    lastName
    email
  }
}

# Get a specific user
query GetUser($id: ID!) {
  user(id: $id) {
    id
    firstName
    lastName
    email
  }
}

Example

Querying group members through a group (based on the Legalesign Console app):

query GetGroupUsers {
  group(id: "Z3JwbGVnYWxlc2lnbxRldg==") {
    memberConnection {
      groupMembers {
        user {
          id
          email
          firstName
          lastName
          name
        }
      }
    }
  }
}

Full user profile with organisations and group memberships:

query GetUserProfile {
  user {
    id
    name
    firstName
    lastName
    email
    timeZone
    lastDocumentSentAt
    uploadedTemplatesCount
    organisationConnection {
      organisations {
        id
        name
      }
    }
    memberConnection(first: 20) {
      groupMembers {
        id
        canAdminister
        canCreateSend
        canEdit
        isActive
        group {
          id
          name
          credit
        }
      }
    }
    webhooks {
      id
      url
      event
      enabled
      groupId
    }
  }
}

Related

• Organisation — organisations this user belongs to
• Group — groups accessed through memberships
• GroupMember — membership records with permissions
• Query Examples — basic user query
• Complex Query Examples — user with nested data
• Mutation Examples — update user mutations