Resources
Users
List and retrieve the users who own records in your Dreamteam workspace. Users are the actors referenced by every record's owner_id and created_by fields.
List Users
Returns the users in your organization that you have access to. Sensitive fields (passwords, tokens, OTP codes, API keys) are never returned in this response.
Query parameters
page integer | Page number, starts at 1. Defaults to 1. |
page_size integer | Page size. Default 20. Max 100 - higher values are silently capped at 100 (no error). Defaults to 20. |
sort string | Sort spec |
Returns
A paginated user list with the same shape as records list responses (results + metadata). Each user object includes id, first_name, last_name, primary_email, username, role, title, status, sales_user, and created_at.
Fields
role | One of admin, sales_manager, sales_member. |
status | One of ACTIVATED (can log in), CREATED (invited, not yet activated), SUSPENDED (access revoked). |
sales_user | Boolean. Whether this user is counted against the workspace's paid sales seats. |
Sensitive fields are never returned
Tokens, passwords, API keys, and OTP codes are stripped from every user response.
curl 'https://api.dreamteamcrm.ai/api/v1/users?page=1&page_size=20&sort=created_at,desc' \
-H 'Authorization: Bearer <YOUR_TOKEN>'{
"results": [
{
"id": 1000054,
"first_name": "Arjun",
"last_name": "Manager",
"primary_email": "arjun+mgr@example.com",
"username": "arjun+mgr@example.com",
"role": "sales_member",
"title": "",
"status": "ACTIVATED",
"sales_user": false,
"created_at": "2026-06-12T06:33:35.139985Z"
},
{
"id": 1000051,
"first_name": "Akarsh",
"last_name": "",
"primary_email": "akarsh@example.com",
"username": "akarsh@example.com",
"role": "sales_member",
"title": "GTM - Sales",
"status": "ACTIVATED",
"sales_user": false,
"created_at": "2026-06-08T10:29:13.104277Z"
}
],
"metadata": {
"page": 1,
"page_size": 20,
"total_elements": 45,
"total_pages": 3,
"has_next": true,
"has_previous": false
}
}{
"results": [
{
"id": "integer",
"first_name": "string",
"last_name": "string",
"primary_email": "string",
"username": "string",
"role": "enum (admin, sales_manager, sales_member)",
"title": "string",
"status": "enum (ACTIVATED, CREATED, SUSPENDED)",
"sales_user": "boolean",
"created_at": "string"
}
],
"metadata": {
"page": "integer",
"page_size": "integer",
"total_elements": "integer",
"total_pages": "integer",
"has_next": "boolean",
"has_previous": "boolean"
}
}Get User by ID
Sensitive fields (passwords, tokens, OTP codes, API keys) are never returned in this response.
Path parameters
id integer · required | Numeric identifier of the user. |
Returns
User
curl 'https://api.dreamteamcrm.ai/api/v1/users/1000001' \
-H 'Authorization: Bearer <YOUR_TOKEN>'{
"associations": null,
"created_at": "2026-06-12T06:24:58.831219Z",
"first_name": "Jordan",
"id": 1000052,
"last_name": "Rivera",
"primary_email": "jordan.rivera@example.com",
"role": "sales_member",
"sales_user": false,
"status": "CREATED",
"title": "",
"username": "jordan.rivera@example.com"
}{
"id": "integer",
"first_name": "string",
"last_name": "string",
"primary_email": "string",
"username": "string",
"role": "enum (admin, sales_manager, sales_member)",
"title": "string",
"status": "enum (ACTIVATED, CREATED, SUSPENDED)",
"sales_user": "boolean",
"created_at": "string"
}