← API reference
CANONICAL TYPE REFERENCE

UpsertUserInput

Input for creating or updating a service account

ID for update; omit for create

External system identifier

emailString!

Email address (required)

nameString

Display name

Service-account type. BOT is the only accepted value and the default — HUMAN users are provisioned by Control, not created here.

View exact SDL
"""Input for creating or updating a service account"""
input UpsertUserInput {
  """ID for update; omit for create"""
  id: UserID
  """External system identifier"""
  externalId: String
  """Email address (required)"""
  email: String!
  """Display name"""
  name: String
  """
  Service-account type. BOT is the only accepted value and the default — HUMAN users are provisioned by Control, not created here.
  """
  kind: UserKind
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.