Zum Hauptinhalt springen
GET
/
settings
/
v3
/
users
/
{userId}
Ruft einen Benutzer ab
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
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

Authorization
string
header
erforderlich

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

Pfadparameter

userId
string
erforderlich

ID des Benutzers, für den Daten abgerufen werden sollen

Abfrageparameter

idProperty
enum<string>

Der Name einer Eigenschaft mit eindeutigen Benutzerwerten. Gültige Werte sind „USER_ID“ (Standard) oder „EMAIL“.

Verfügbare Optionen:
EMAIL,
USER_ID

Antwort

successful operation

email
string
erforderlich

Die E-Mail des Benutzers.

id
string
erforderlich

Die eindeutige ID des Benutzers.

roleIds
string[]
erforderlich

Eine Liste der Rollen-IDs, die dem Benutzer zugewiesen sind.

superAdmin
boolean
erforderlich

Ob der Benutzer Super-Admin-Berechtigungen besitzt.

firstName
string

Der Vorname des Benutzers.

lastName
string

Der Nachname des Benutzers.

primaryTeamId
string

Das primäre Team des Benutzers

roleId
string

Die Rolle des Benutzers.

secondaryTeamIds
string[]

Die zusätzlichen Teams des Benutzers.

sendWelcomeEmail
boolean

Ob eine Begrüßungs-E-Mail an den Benutzer gesendet wurde. Dieser Wert wird nur in Reaktion auf einen Bereitstellungsantrag engetragen. Nachfolgende Abfragen erhalten den Wert „false“.

Last modified on March 24, 2026