Zum Hauptinhalt springen
PUT
/
settings
/
v3
/
users
/
{userId}
Ändert einen Benutzer
curl --request PUT \
  --url https://api.hubapi.com/settings/v3/users/{userId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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
}

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

Body

application/json
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.

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