Listar Usuarios (Vendedores)

GET /external/v1/users

Retorna os membros do time (vendedores) da sua conta. Use para resolver os campos owner_user_id / assigned_user_id retornados por oportunidades e conversas. Campos sensiveis (como hash de senha) nunca sao expostos.

Autenticacao

Requer permissao users:read.

Parametros de Query

Parametro	Tipo	Padrao	Descricao
role	string	-	Filtrar por funcao
is_active	boolean	-	Filtrar por status ativo (true / false)

Requisicao

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())

Resposta

{
  "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"
    }
  ]
}

Campos de Resposta

Campo	Tipo	Descricao
id	string	Identificador do usuario
name	string	Nome completo
email	string	Endereco de e-mail
role	string	Funcao do usuario
is_active	boolean	Se o usuario esta ativo
avatar_url	string	URL do avatar/foto de perfil (nullable)
created_at	string	Timestamp ISO 8601 de criacao
last_seen_at	string	Timestamp ISO 8601 da ultima atividade (nullable)