Create a verification

Registers a user and returns a verification_url. Redirect or link your user to this URL so they can complete the liveness check. After completion, the user is redirected back to redirect with vy_token and vy_status query parameters appended.

POST /v2/verification/create

Create a verification

cURL

curl --request POST \
  --url https://api.connect.verifyyou.com/v2/verification/create \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_id": "user_123",
  "redirect": "https://yourapp.com/done",
  "region": "event_2026_austin"
}
'

200

{
  "verification_url": "https://verifyyou.com/i/A3KF9X",
  "external_id": "user_123"
}

Authorizations

API-KEY · string · header · required

Your VerifyYou API key.

Body

application/json

external_id · string

Your application's user identifier. If omitted, a UUID is generated automatically.

Example:

"user_123"

redirect · string<uri>

URL the user is redirected to after completing verification. vy_token and vy_status query parameters are appended.

Example:

"https://yourapp.com/done"

region · string

Limits each verified person to one account per region, preventing duplicate accounts and fraud within the same context. Use this when you need one real human per context — e.g. one account per competition, one response per form, or one player per server. Users already verified can connect to new regions instantly without redoing the liveness check. If omitted, each person is limited to one account across your entire integration.

Example:

"event_2026_austin"

Response

200

application/json

Verification created successfully.

verification_url · string<uri>

URL to send the user to for verification.

Example:

"https://verifyyou.com/i/A3KF9X"

external_id · string

The external_id used for this verification. Matches what you sent, or the auto-generated ID if omitted.

Example:

"user_123"