Users
Retrieve user information such as working hours, time zone, additional phone numbers, and job title.
View Specific Information
User Object
SELECT
When querying Users, filtering can be applied to columns marked as "Filterable." For these columns, the supported server-side operators are = != IN.
SELECT * FROM Users;
SELECT * FROM Users WHERE Id = '46193633729';
SELECT * FROM Users WHERE JobTitle = 'Developer';
SELECT * FROM Users WHERE AvailabilityStatus = 'away';
SELECT * FROM Users WHERE AdditionalPhone = '+13123456789';
SELECT * FROM Users WHERE StandardTimeZone = 'America/New_York';
Difference Between Users, UserProvisioning, and Owners.
The Users table contains details about users within a specific HubSpot account, including properties such as working hours, time zone, phone number, and job title. A user in the Users table represents a user only within the HubSpot account from which the data was requested. This differs from the users in the UserProvisioning table, which refer to users across all accounts, and the users in the Owners table, which refer to users as owners of records.
Columns
| Name | Type | References | Filterable | Description |
| Id [KEY] | String | True | The unique identified of the user. | |
| CreatedAt | Datetime | False | When the user was created. | |
| UpdatedAt | Datetime | False | When the user was last updated. | |
| Archived | Boolean | False | Whether the user is archived or not. | |
| AdditionalPhone | String | True | The user’s additional phone number. | |
| AvailabilityStatus | String | True | The user’s availability status. The value must be either 'available' or 'away''. | |
| JobTitle | String | True | The user’s job title. | |
| MainLanguageSkill | String | False | The user’s main language skill. The value must match an existing language skill. | |
| SecondaryLanguageSkill | String | False | The user’s secondary language skill. The value must match an existing language skill. | |
| OutOfOfficeHours | String | False | The user’s out of office hours. | |
| StandardTimeZone | String | True | The user’s timezone. Timezone values must use standard TZ identifiers, such as 'America/New_York' or 'Europe/Dublin' | |
| UncategorizedSkills | String | True | The user’s custom uncategorized skill. This property value must match an existing custom uncatgorized skill in the portal. | |
| WorkingHours | String | False | The user’s working hours. |