BetterCloud · Schema

User

A user discovered and managed across BetterCloud integrations.

AutomationComplianceEnterpriseIT OperationsSaaS ManagementSecurityWorkflowsUser Lifecycle

Properties

Name	Type	Description
id	string	Unique identifier for the user in BetterCloud.
email	string	Primary email address of the user.
first_name	string	User's first name.
last_name	string	User's last name.
status	string	Current status of the user.
department	string	Department or organizational unit.
title	string	Job title.
manager_email	string	Email of the user's manager.
location	string	Office location.
created_at	string	When the user was first discovered.
updated_at	string	When the user record was last updated.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/bettercloud/refs/heads/main/json-schema/bettercloud-user-schema.json",
  "title": "User",
  "description": "A user discovered and managed across BetterCloud integrations.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the user in BetterCloud.",
      "example": "user-a1b2c3d4"
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Primary email address of the user.",
      "example": "[email protected]"
    },
    "first_name": {
      "type": "string",
      "description": "User's first name.",
      "example": "Jane"
    },
    "last_name": {
      "type": "string",
      "description": "User's last name.",
      "example": "Smith"
    },
    "status": {
      "type": "string",
      "description": "Current status of the user.",
      "enum": [
        "active",
        "suspended",
        "deprovisioned"
      ],
      "example": "active"
    },
    "department": {
      "type": "string",
      "nullable": true,
      "description": "Department or organizational unit.",
      "example": "Engineering"
    },
    "title": {
      "type": "string",
      "nullable": true,
      "description": "Job title.",
      "example": "Senior Engineer"
    },
    "manager_email": {
      "type": "string",
      "format": "email",
      "nullable": true,
      "description": "Email of the user's manager.",
      "example": "[email protected]"
    },
    "location": {
      "type": "string",
      "nullable": true,
      "description": "Office location.",
      "example": "San Francisco"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "When the user was first discovered.",
      "example": "2025-01-15T10:00:00Z"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "When the user record was last updated.",
      "example": "2026-04-01T08:30:00Z"
    }
  }
}