Skip to main content

Kind: User

SaaS users should only use this to create entities for people outside of their company.

People inside your company are automatically created by the system once they have logged into the Client Portal. The system will not behave correctly if multiple records are created for the same individual.

A user describes a person such as an employee, a contractor, or similar. User can be associated with Kind: Person entities in OpenContext. User entities integrate with the authentication system, and the record will be required to be able to log in.


A key that ends with a question mark is optional.

For example, spec.profile.displayName

kind: User
name: string
primaryEmail: string
displayName?: string
displayEmail?: string
picture?: string
role?: string
timezone?: string
slackHandle?: string
pagerHandle?: string
ownerOf: string[]
  • apiVersion: [required]
  • kind: User [required]
  • metadata: (ObjectMeta) [optional] Standard object’s metadata. For more information see the Common to All Kinds doc
  • spec: (Spec) [required] Specification to describe a person such as an employee, a contractor, or similar. User can be associated with Kind: Person entities in OpenContext.


  • primaryEmail (string) [required] The email address for user authentication.
  • profile [optional] Optional profile information about the user. Mainly for display purposes. All fields of this structure are also optional. The displayName would be what is presented to users in the system. The displayEmail would be a user email of some form, that the user may wish to be used for contacting them. The picture is expected to be a URL pointing to an image that's representative of the user, and that a browser could fetch and render on a group page or similar. The role would indicate the user’s role. The timezone should be in the form of TZ database name. The slackHandle and pagerHandle are the user’s handle name in Slack and the paging service of choice respectively.
  • ownerOf (string array) [optional] An array of entity references to Person entities that the user is associated with.


These example YAML configurations are all shown as if they were in their own file. They can be concatenated into a single file by separating the contents with a triple dash --- like in Kubernetes.

kind: User
name: paul
displayName: Paul
timezone: Australia/Perth
slackHandle: paul
pagerHandle: paul
role: Engineer
ownerOf: [paul-github, paul]