Create an auth session | Vlens

Creates a server-side session token for a user. Pass the token to the Vlens iframe or WebView to embed the full verification and contracting UX without exposing your API key to the client. Requires only ApiKey — no admin token.

Authentication

ApiKeystring

Static API key issued to your tenant. Required on every request.

Request

This endpoint expects an object.

phoneNumberstringRequired

The user's registered phone number.

sessionPermissionsobjectOptional

Controls what the user is allowed to do in the session.

Response

Session created. Use data.token to load the Vlens iframe.

dataobject

error_codeinteger or null

error_messagestring or null

error_descriptionslist of objects or null

$	curl -X POST https://api.vlenseg.com/api/IdentityUserSession/CreateAuthSession \
>	-H "ApiKey: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"phoneNumber": "+201234567890"
>	}'

1	{
2	"data": {
3	"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1Njc4OSIsInNlc3Npb25JZCI6IjEyMzQ1NiIsImV4cCI6MTY4OTAwMDAwMH0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
4	},
5	"error_code": 0,
6	"error_message": "",
7	"error_descriptions": []
8	}