Zum Hauptinhalt springen
POST
/
settings
/
v3
/
users
Fügt einen Benutzer hinzu
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
}

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.

Body

application/json
email
string
erforderlich

Die E-Mail des Benutzers.

sendWelcomeEmail
boolean
erforderlich

Ob eine Begrüßungs-E-Mail gesendet werden soll.

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