← All types
Platform & adminIn Input object

UpsertUserInput

Input for creating or updating a service account

Fields

id

UserIDOptional

ID for update; omit for create

External system identifier

HTTP(S) link to this record in the external system. Requires an external identity. Omit to preserve the existing link, or pass null to clear it. Removing the external identity also removes its link.

email

String!Required

Email address (required)

name

StringOptional

Display name

kind

UserKindOptional

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

Possible values (2)
HUMAN

Regular interactive user

BOT

Service account for webhooks and automations

Referenced by (1)
Exact type SDL
"""Input for creating or updating a service account"""
input UpsertUserInput {
  """ID for update; omit for create"""
  id: UserID
  """External system identifier"""
  externalId: String
  """
  HTTP(S) link to this record in the external system. Requires an external identity. Omit to preserve the existing link, or pass null to clear it. Removing the external identity also removes its link.
  """
  externalUrl: 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
}