Associate authenticator to user

https://api.socialidnow.com/v1

POST

/authenticators

Associates the authenticator to the user. It generates a challenge and sends it to the channel if supported by the authenticator type.

The remaining parameters depend on the authenticator type.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Created. Authenticator successfully associated.

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.socialidnow.com/v1/authenticators' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "totp"
}'

Response Example

{
    "authenticator_id": "d6a28da7-d32e-44ee-85ea-37097548322d",
    "type": "totp",
    "verified": false,
    "created_at": "2019-04-25T20:13:17.000Z",
    "updated_at": "2019-04-25T20:13:17.000Z",
    "qr_code_uri": "otpauth://totp/CoffeeBean:johndoe?secret=3hlwux3vrutc6p3baec6yzghucwtumyp&issuer=CoffeeBean",
    "otp_secret": "3hlwux3vrutc6p3baec6yzghucwtumyp"
}

Modified at 2025-08-19 19:12:55

List all factors

Generate authenticator challenge