Saltar al contenido principal
GET
/
settings
/
v3
/
users
/
{userId}
Recupera un usuario
curl --request GET \
  --url https://api.hubapi.com/settings/v3/users/{userId} \
  --header 'Authorization: Bearer <token>'
{
  "email": "<string>",
  "id": "<string>",
  "roleIds": [
    "<string>"
  ],
  "superAdmin": true,
  "firstName": "<string>",
  "lastName": "<string>",
  "primaryTeamId": "<string>",
  "roleId": "<string>",
  "secondaryTeamIds": [
    "<string>"
  ],
  "sendWelcomeEmail": true
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de ruta

userId
string
requerido

Identificador del usuario que se recuperará

Parámetros de consulta

idProperty
enum<string>

El nombre de una propiedad con valores de usuario únicos. Los valores válidos son "USER_ID" (predeterminado) o "EMAIL"

Opciones disponibles:
EMAIL,
USER_ID

Respuesta

successful operation

email
string
requerido

El correo electrónico del usuario.

id
string
requerido

El ID único del usuario.

roleIds
string[]
requerido

Una lista de los ID de rol asignados al usuario.

superAdmin
boolean
requerido

Si el usuario tiene privilegios de superadministrador.

firstName
string

El nombre del usuario.

lastName
string

El apellido del usuario.

primaryTeamId
string

El equipo principal del usuario

roleId
string

El rol del usuario.

secondaryTeamIds
string[]

Los equipos adicionales del usuario.

sendWelcomeEmail
boolean

Si se envió un correo electrónico de bienvenida al usuario. Este valor solo se rellenará en respuesta a una solicitud de aprovisionamiento. Las consultas posteriores serán falsas.

Last modified on March 30, 2026