Initiate Verification Enrollment

POST 
/verification-actions-srv/setup/:method/initiation/:trackId

Scenario 1 (Public endpoint with track ID)

This API callallows users to set up additional login methods (suggested verification methods) when in an authorized state.

Verification Method Setup appears on the Overview Page. Methods can be asynchronous (Push, TouchID) or synchronous (FIDO2).

Scenario 2 (without track ID)

Initiate verification enrollment from user profile using a secure endpoint. Users are validated before enrollment begins.

Note: Security applies only to scenario 2.

You can pass any scope from the below scopes in the user token (applicable only for scenario 2).

Request

Responses

200

OK

400

Bad request.

On errors, this verification-actions-srv endpoint returns success: false with a top-level string code (VER_*) and status (HTTP status).

Common code values:

code	Meaning
VER_0025	Invalid trackId path parameter
VER_0030	Invalid verification {method}
VER_0028	Verification method is not active
VER_0029	Verification method is already configured
VER_0005	Required request data is missing
VER_0004	Invalid or malformed request payload

For the full Verification Actions error catalogue, see Verification actions service error codes.