Skip to main content

AdminSignupSocialRequest

Package: @nauth-toolkit/client Type: Request

Request payload for admin social user import. Allows administrators to import existing social users from external platforms (e.g., Cognito, Auth0) with social account linkage.

import { AdminSignupSocialRequest } from '@nauth-toolkit/client';

Properties

PropertyTypeRequiredDescription
emailstringYesUser email address. Must be valid email format.
firstNamestringNoUser first name
lastNamestringNoUser last name
metadataRecord<string, unknown>NoCustom metadata object (saved to user record)
mustChangePasswordbooleanNoForce password change on first login. Default: false.
passwordstringNoOptional password for hybrid social+password accounts
phonestringNoPhone number in E.164 format (e.g., +14155551234)
isPhoneVerifiedbooleanNoBypass phone verification requirement. Default: false.
provider'google' | 'apple' | 'facebook'YesSocial provider name
providerEmailstringNoProvider's email address
providerIdstringYesProvider's unique user identifier
socialMetadataRecord<string, unknown>NoRaw OAuth profile data from provider
usernamestringNoOptional username

Example

Social-only user:

{
"email": "user@example.com",
"provider": "google",
"providerId": "google_12345",
"providerEmail": "user@gmail.com",
"firstName": "John",
"lastName": "Doe",
"socialMetadata": {
"sub": "google_12345",
"given_name": "John",
"family_name": "Doe"
}
}

Hybrid user (social + password):

{
"email": "user@example.com",
"password": "SecurePass123!",
"provider": "apple",
"providerId": "apple_67890",
"firstName": "Jane",
"lastName": "Smith",
"isPhoneVerified": true,
"phone": "+14155551234"
}

Used By