Find User by Identifier (Authenticated)
POST/useractions-srv/userexistence
This API finds users by identifier (email, mobile_number, custom username field, sub, identityId, or providerUserId).
Backend API: This endpoint is designed for backend systems to check user existence and retrieve user information. It is not intended for use in web applications or frontend code.
Use Cases:
- Check if a user exists before creating a new account
- Retrieve user information by various identifiers
- Validate user identifiers in backend workflows
- Lookup users by external provider user IDs
Note: For web application user existence checks with webfinger redirection, use /useractions-srv/userexistence/{requestId} instead.
Required Roles: admin, secondary_admin, or user_read
Request
Responses
- 200
- 204
- 400
- 401
- 417
OK
User does not exist for the supplied identifier — the account is not in the tenant (not an empty search result set).
The response body uses the standard error envelope with code 10301 (user not found).
Bad Request
Unauthorized
Expectation Failed