Slack · Schema

User

A Slack user object representing a workspace member with their profile, roles, and settings.

BotsChatCollaborationMessagingProductivityT1Team Communication

Properties

Name	Type	Description
id	string	The unique identifier for this user.
team_id	string	The workspace team ID this user belongs to.
name	string	The user's username.
deleted	boolean	Whether the user has been deactivated.
color	string	A hex color code used in certain client displays for this user.
real_name	string	The user's real name.
tz	string	The user's timezone identifier (e.g., "America/Los_Angeles").
tz_label	string	Descriptive label for the user's timezone.
tz_offset	integer	The user's timezone offset from UTC in seconds.
profile	object	The user's profile information.
is_admin	boolean	Whether the user is a workspace admin.
is_owner	boolean	Whether the user is a workspace owner.
is_primary_owner	boolean	Whether the user is the primary workspace owner.
is_restricted	boolean	Whether the user is a guest with single-channel access.
is_ultra_restricted	boolean	Whether the user is a single-channel guest.
is_bot	boolean	Whether the user is a bot.
is_app_user	boolean	Whether the user is an app user.
updated	integer	Unix timestamp of when the user was last updated.
has_2fa	boolean	Whether the user has two-factor authentication enabled.
locale	string	IETF language code for the user. Only included when specifically requested.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "User",
  "type": "object",
  "description": "A Slack user object representing a workspace member with their profile, roles, and settings.",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier for this user."
    },
    "team_id": {
      "type": "string",
      "description": "The workspace team ID this user belongs to."
    },
    "name": {
      "type": "string",
      "description": "The user's username."
    },
    "deleted": {
      "type": "boolean",
      "description": "Whether the user has been deactivated."
    },
    "color": {
      "type": "string",
      "description": "A hex color code used in certain client displays for this user."
    },
    "real_name": {
      "type": "string",
      "description": "The user's real name."
    },
    "tz": {
      "type": "string",
      "description": "The user's timezone identifier (e.g., \"America/Los_Angeles\")."
    },
    "tz_label": {
      "type": "string",
      "description": "Descriptive label for the user's timezone."
    },
    "tz_offset": {
      "type": "integer",
      "description": "The user's timezone offset from UTC in seconds."
    },
    "profile": {
      "type": "object",
      "description": "The user's profile information."
    },
    "is_admin": {
      "type": "boolean",
      "description": "Whether the user is a workspace admin."
    },
    "is_owner": {
      "type": "boolean",
      "description": "Whether the user is a workspace owner."
    },
    "is_primary_owner": {
      "type": "boolean",
      "description": "Whether the user is the primary workspace owner."
    },
    "is_restricted": {
      "type": "boolean",
      "description": "Whether the user is a guest with single-channel access."
    },
    "is_ultra_restricted": {
      "type": "boolean",
      "description": "Whether the user is a single-channel guest."
    },
    "is_bot": {
      "type": "boolean",
      "description": "Whether the user is a bot."
    },
    "is_app_user": {
      "type": "boolean",
      "description": "Whether the user is an app user."
    },
    "updated": {
      "type": "integer",
      "description": "Unix timestamp of when the user was last updated."
    },
    "has_2fa": {
      "type": "boolean",
      "description": "Whether the user has two-factor authentication enabled."
    },
    "locale": {
      "type": "string",
      "description": "IETF language code for the user. Only included when specifically requested."
    }
  }
}