Create a user

POST /users

Admin/API-key access. Creates a new user in the tenant from an email (and optional full name), with no password. Combine with the auth token-mint endpoint to issue the user a bearer token.

Parameters

signedChallenge object Required

No description.

tempAuthToken string Required

No description.

x-tenant-id string Required header

Tenant identifier. Required on all tenant-scoped routes.

curl -X POST "https://heimdall.qa.zoniqx.com/users" \ -H "Authorization: Bearer <accessToken>" \ -H "x-tenant-id: <your-tenant-id>" \ -H "Content-Type: application/json" \ -d '{ "signedChallenge": { "firstFactorCredential": { "credentialKind": "Key", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" } }, "secondFactorCredential": { "credentialKind": "Key", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" } }, "recoveryCredential": { "credentialKind": "RecoveryKey", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" }, "encryptedPrivateKey": "string" } }, "tempAuthToken": "string" }'

const response = await fetch("https://heimdall.qa.zoniqx.com/users", { method: "POST", headers: { "Authorization": "Bearer <accessToken>", "x-tenant-id": "<your-tenant-id>", "Content-Type": "application/json", }, body: JSON.stringify({ "signedChallenge": { "firstFactorCredential": { "credentialKind": "Key", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" } }, "secondFactorCredential": { "credentialKind": "Key", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" } }, "recoveryCredential": { "credentialKind": "RecoveryKey", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" }, "encryptedPrivateKey": "string" } }, "tempAuthToken": "string" }), }); const data = await response.json();

type UsersController_createUserResponse = Record<string, unknown>; const response = await fetch("https://heimdall.qa.zoniqx.com/users", { method: "POST", headers: { Authorization: "Bearer <accessToken>", "x-tenant-id": "<your-tenant-id>", "Content-Type": "application/json", }, body: JSON.stringify({ "signedChallenge": { "firstFactorCredential": { "credentialKind": "Key", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" } }, "secondFactorCredential": { "credentialKind": "Key", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" } }, "recoveryCredential": { "credentialKind": "RecoveryKey", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" }, "encryptedPrivateKey": "string" } }, "tempAuthToken": "string" }), }); const data: UsersController_createUserResponse = await response.json();

import requests url = "https://heimdall.qa.zoniqx.com/users" headers = { "Authorization": "Bearer <accessToken>", "x-tenant-id": "<your-tenant-id>", } payload = { "signedChallenge": { "firstFactorCredential": { "credentialKind": "Key", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" } }, "secondFactorCredential": { "credentialKind": "Key", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" } }, "recoveryCredential": { "credentialKind": "RecoveryKey", "credentialInfo": { "credId": "string", "clientData": "string", "attestationData": "string" }, "encryptedPrivateKey": "string" } }, "tempAuthToken": "string" } response = requests.post(url, headers=headers, json=payload) data = response.json()

{ "id": "string", "tenantId": "string", "userType": "person", "fullName": "string", "email": "user@example.com", "phoneNumber": "string", "currentAddressId": "string", "currentKycId": "string", "currentKybId": "string", "currentAccreditationId": "string", "digitalSignatureFileId": "string", "dateOfBirth": "string", "metadata": {}, "createdAt": "2024-01-15T10:30:00Z", "updatedAt": "2024-01-15T10:30:00Z", "currentAddress": {}, "currentAccreditation": {}, "currentKyc": {}, "currentKyb": {}, "evmEoas": [ { "address": "string", "createdAt": "2024-01-15T10:30:00Z" } ], "xrplSecureAccounts": [ {} ], "authMethods": [ { "createdAt": "2024-01-15T10:30:00Z", "identifier": "string", "type": "string", "authVendorData": {} } ] }