Data verifier users

Create data verifier user

POST/v4/onboard/platform/organisation/data-verifier-user

Creates a data verifier user: a person who verifies credentials for your organisation with the Data Verifier mobile app, for example at a front desk. Give a name and at least one of email and phone. No other data verifier user of the organisation can have the same email or the same phone. The check also compares empty values, so only one user of the organisation can have no e-mail address, and only one user can have no phone number.

The response has the API key of the user (apiKey, owsk_...), once. The key is valid for 90 days and has the older scopes config and onboard. To let the user log in to the app, send a magic link with Send magic link to data verifier user: the link revokes this key, and the app gets a new key when it opens the link.

Language of the request sample

curl -X POST 'https://demo-api.igrant.io/v4/onboard/platform/organisation/data-verifier-user' \
  -H 'Authorization: ApiKey <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Front desk verifier",
  "email": "[email protected]"
}'

{
  "dataVerifierUser": {
    "id": "6af1c3d2e4b5a69788990a1b",
    "organisationId": "6ae2bf741c3dadfeb27982ec",
    "name": "Front desk verifier",
    "email": "[email protected]",
    "phone": "",
    "disabled": false,
    "timeStamp": "2026-10-28T09:14:03Z",
    "apiKey": "owsk_<api-key>"
  }
}

Authorizations

Authorizationstringheaderrequired
Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.
Scope:data-verifier-users:create

Body

application/json

The data verifier user to create.

namestringrequired
The name of the user.
At least 1 character.
Example:"Front desk verifier"
emailstring
The e-mail address that gets the magic link. Give email, phone or both.
Example:"[email protected]"
phonestring
The phone number that gets the magic link by SMS, with the country code. Give email, phone or both.
Example:"+46701234567"

Response

application/json

The new data verifier user, with its API key.

dataVerifierUserobject
A person who verifies credentials for the organisation with the Data Verifier mobile app.