Skip to content
Esc
navigateopen⌘Jpreview
Dashboard

Sign up WebAuthn user

Sign up the user using the WebAuthn credential.

POST/appid-{appId}/{tenantId}/recipe/webauthn/signup
Authorization
api-keyAPI key · headerrequired
The core service API token. If you are using a self-hosted core service and you have not generated a token, you can omit the header.
Path parameters
tenantIdstring
The tenant against which the request is made. If left empty, the default tenant will be used.
Header parameters
cdi-versionstring
X.Y of the X.Y.Z CDI version.
Request body
application/json
webauthnGeneratedOptionsIdstring
credentialobject
Credential returned by the browser
Responses
200The signup result
One of:
object
statusstatusOK
Allowed:OK
webauthnCredentialIdstring
relyingPartyIdstring
relyingPartyNamestring
recipeUserIdstring
userauthRecipeUser
Show properties
iduserId
isPrimaryUserboolean
tenantIdstenantId[]
timeJoinedtimeJoined
emailsemail[]
phoneNumbersphoneNumber[]
thirdPartyobject[]
Show properties
Array of object
idthirdPartyId
userIdthirdPartyUserId
loginMethodsobject[]
Show properties
Array of object
tenantIdstenantId[]
recipeUserIduserId
verifiedboolean
timeJoinedtimeJoined
recipeIdrecipeId
Allowed:emailpasswordpasswordlessthirdparty
emailemail
phoneNumberphoneNumber
thirdPartyobject
Show properties
idthirdPartyId
userIdthirdPartyUserId
object
statusstring
Allowed:INVALID_OPTIONS_ERRORINVALID_AUTHENTICATOR_ERRORINVALID_CREDENTIALS_ERROR
reasonstring
object
statusstring
Allowed:OPTIONS_NOT_FOUND_ERROREMAIL_ALREADY_EXISTS_ERROR
400error code 400
string
401error code 401
string
404error code 404
string
500error code 500
string
Try it
Server
Authorization
Parameters
Bodyapplication/json
Request
curl -X POST "/appid-{appId}/public/recipe/webauthn/signup" \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "webauthnGeneratedOptionsId": "fa7a0841-b533-4478-9253-0fde890c576",
  "credential": {}
}'
Response
{
  "status": "OK",
  "webauthnCredentialId": "fa7a0841-b533-4478-9253-0fde890c576",
  "relyingPartyId": "example.com",
  "relyingPartyName": "Example",
  "recipeUserId": "fa7a0841-b533-4478-9253-0fde890c576",
  "user": {
    "id": "fa7a0841-b533-4478-95533-0fde890c3483",
    "isPrimaryUser": true,
    "tenantIds": [
      "customer1"
    ],
    "timeJoined": 1623918032231,
    "emails": [
      "[email protected]"
    ],
    "phoneNumbers": [
      "+14155552671"
    ],
    "thirdParty": [
      {
        "id": "google",
        "userId": 106347997792363870000
      }
    ],
    "loginMethods": [
      {
        "tenantIds": [
          "customer1"
        ],
        "recipeUserId": "fa7a0841-b533-4478-95533-0fde890c3483",
        "verified": true,
        "timeJoined": 1623918032231,
        "recipeId": "emailpassword",
        "email": "[email protected]",
        "phoneNumber": "+14155552671",
        "thirdParty": {
          "id": "google",
          "userId": 106347997792363870000
        }
      }
    ]
  }
}

API reference

API schema and response details