メインコンテンツへスキップ
GET
/
settings
/
v3
/
users
/
{userId}
ユーザーが取得されます
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
}

サポートされる製品

次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -無料ツール

承認

Authorization
string
header
必須

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

パスパラメータ

userId
string
必須

取得するユーザーのID

クエリパラメータ

idProperty
enum<string>

固有のユーザー値を含むプロパティーの名前。有効な値は「USER_ID」(デフォルト)または「EMAIL」です

利用可能なオプション:
EMAIL,
USER_ID

レスポンス

successful operation

email
string
必須

ユーザーのEメール。

id
string
必須

ユーザーの固有ID。

roleIds
string[]
必須

ユーザーに割り当てられた役割IDのリスト。

superAdmin
boolean
必須

ユーザーがスーパー管理者特権を持っているかどうか。

firstName
string

ユーザーの名。

lastName
string

ユーザーの姓。

primaryTeamId
string

ユーザーのプライマリーチーム

roleId
string

ユーザーの役割。

secondaryTeamIds
string[]

ユーザーの追加チーム。

sendWelcomeEmail
boolean

ウェルカムEメールがユーザーに送信されたかどうか。この値は、プロビジョニングリクエストへのレスポンスとしてのみ入力されます。後続のクエリーはfalseになります。

Last modified on March 30, 2026