List Users (Sellers)

GET /external/v1/users

Returns the team members (sellers) of your account. Use this to resolve the owner_user_id / assigned_user_id fields returned by opportunities and conversations. Sensitive fields (such as password hashes) are never exposed.

Authentication

Requires users:read permission.

Query Parameters

Parameter	Type	Default	Description
role	string	-	Filter by role
is_active	boolean	-	Filter by active status (true / false)

Request

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/users?is_active=true" \
  --header "X-API-Key: YOUR_API_KEY"

Node.js

const axios = require('axios');

const response = await axios.get('https://app.getraze.com/external/v1/users', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  params: { is_active: true }
});

console.log(response.data);

Python

import requests

response = requests.get(
    'https://app.getraze.com/external/v1/users',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    params={'is_active': 'true'}
)

print(response.json())

Response

{
  "success": true,
  "data": [
    {
      "id": "usr_42",
      "name": "Maria Silva",
      "email": "maria@acme.com",
      "role": "seller",
      "is_active": true,
      "avatar_url": "https://cdn.getraze.com/avatars/usr_42.jpg",
      "created_at": "2026-01-10T08:00:00Z",
      "last_seen_at": "2026-01-20T14:00:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
id	string	User identifier
name	string	Full name
email	string	Email address
role	string	User role
is_active	boolean	Whether the user is active
avatar_url	string	Avatar/profile picture URL (nullable)
created_at	string	ISO 8601 creation timestamp
last_seen_at	string	ISO 8601 last activity timestamp (nullable)