PendingUser is a datatype for information on a pending user, a user that was invited to join the organization.

This datatype is used by both the pendingUser() and pendingUsers() query fields, and by the union datatype, userOrPendingUser, which is used by the addUserV2() mutation field.

Table: PendingUser

ParameterTypeRequiredDefaultStabilityAvailabilityDescription
Some input parameters may be required, as indicated in the Required column. For return values, this indicates that you are assured a value if the field is requested for the results. 
Table last updated: Oct 14, 2026 
createdAtLongyes Long-Term The time the pending user was created.
idStringyes Long-Term The identifier or token for the pending user.
idpBooleanyes Long-Term Whether IdP is enabled for the organization.
invitedByEmailStringyes Long-Term The email address of the user that invited the pending user.
invitedByNameStringyes Long-Term The name of the user that invited the pending user.
newUserEmailStringyes Long-Term The email of the pending user.
orgNameStringyes Long-Term The name of the organization for the pending user.
pendingUserStatePendingUserStateyes Long-Term The current organization state for the user. See PendingUserState.