WorkOS · Schema

UserlandUser

The user object.

AuthenticationIdentity ProviderSSOSAMLOIDCSCIMDirectory SyncAuthorizationFGAAudit LogsMFAB2B SaaSAgentsMCP

Properties

Name Type Description
object string Distinguishes the user object.
id string The unique ID of the user.
first_name stringnull The first name of the user.
last_name stringnull The last name of the user.
profile_picture_url stringnull A URL reference to an image representing the user.
email string The email address of the user.
email_verified boolean Whether the user's email has been verified.
external_id stringnull The external ID of the user.
metadata object Object containing metadata key/value pairs associated with the user.
last_sign_in_at stringnull The timestamp when the user last signed in.
locale stringnull The user's preferred locale.
created_at string An ISO 8601 timestamp.
updated_at string An ISO 8601 timestamp.
View JSON Schema on GitHub

JSON Schema

workos-userlanduser-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/UserlandUser",
  "title": "UserlandUser",
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "description": "Distinguishes the user object.",
      "const": "user"
    },
    "id": {
      "type": "string",
      "description": "The unique ID of the user.",
      "example": "user_01E4ZCR3C56J083X43JQXF3JK5"
    },
    "first_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "The first name of the user.",
      "example": "Marcelina"
    },
    "last_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "The last name of the user.",
      "example": "Davis"
    },
    "profile_picture_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "A URL reference to an image representing the user.",
      "example": "https://workoscdn.com/images/v1/123abc"
    },
    "email": {
      "type": "string",
      "description": "The email address of the user.",
      "example": "[email protected]"
    },
    "email_verified": {
      "type": "boolean",
      "description": "Whether the user's email has been verified.",
      "example": true
    },
    "external_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "The external ID of the user.",
      "example": "f1ffa2b2-c20b-4d39-be5c-212726e11222"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "maxLength": 600
      },
      "description": "Object containing metadata key/value pairs associated with the user.",
      "example": {
        "timezone": "America/New_York"
      },
      "propertyNames": {
        "maxLength": 40
      },
      "maxProperties": 50
    },
    "last_sign_in_at": {
      "format": "date-time",
      "type": [
        "string",
        "null"
      ],
      "description": "The timestamp when the user last signed in.",
      "example": "2025-06-25T19:07:33.155Z"
    },
    "locale": {
      "type": [
        "string",
        "null"
      ],
      "description": "The user's preferred locale.",
      "example": "en-US"
    },
    "created_at": {
      "format": "date-time",
      "type": "string",
      "description": "An ISO 8601 timestamp.",
      "example": "2026-01-15T12:00:00.000Z"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string",
      "description": "An ISO 8601 timestamp.",
      "example": "2026-01-15T12:00:00.000Z"
    }
  },
  "required": [
    "object",
    "id",
    "first_name",
    "last_name",
    "profile_picture_url",
    "email",
    "email_verified",
    "external_id",
    "last_sign_in_at",
    "created_at",
    "updated_at"
  ],
  "description": "The user object."
}