Saltar al contenido principal
POST
/
settings
/
v3
/
users
Agrega un usuario
curl --request POST \
  --url https://api.hubapi.com/settings/v3/users/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "sendWelcomeEmail": true,
  "firstName": "<string>",
  "lastName": "<string>",
  "primaryTeamId": "<string>",
  "roleId": "<string>",
  "secondaryTeamIds": [
    "<string>"
  ]
}
'
{
  "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.

Cuerpo

application/json
email
string
requerido

El correo electrónico del usuario.

sendWelcomeEmail
boolean
requerido

Si enviar un correo electrónico de bienvenida.

firstName
string

El nombre del usuario.

lastName
string

Los apellidos del usuario.

primaryTeamId
string

El equipo principal del usuario.

roleId
string

El rol del usuario.

secondaryTeamIds
string[]

Los equipos adicionales del usuario.

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