Choose a version:

user

query

Entry point to user-scoped queries.

Anchor to Possible returnsPossible returns

The authenticated user. Fields are gated by the access token's granted scopes; fields not granted by the token resolve to null.

Anchor to avataravatar •String: URL of the user's avatar image. Requires the avatar or profile scope.
Anchor to emailemail •String: The user's email address. Requires email (also granted by email:verified or user:manage).
Anchor to emailVerifiedemailVerified •Boolean: Whether the user's email has been verified. Requires email (also granted by email:verified or user:manage).
Anchor to familyNamefamilyName •String: The user's family (last) name. Requires the name or profile scope.
Anchor to givenNamegivenName •String: The user's given (first) name. Requires the name or profile scope.
Anchor to namename •String: The user's full name (given + family). Requires the name or profile scope.
Anchor to phonephone •String: The user's phone number. Requires phone (also granted by phone:verified or user:manage). Returns null if the user has no phone on record.
Anchor to phoneVerifiedphoneVerified •Boolean: Whether the user's phone number has been verified. Requires phone (also granted by phone:verified or user:manage). Returns null if the user has no phone on record.
Anchor to subsub •String: Stable subject identifier of the user. Always present when the token authenticates a user; not gated by a specific scope.

Was this section helpful?