API endpoints overviewSessions
Create session
Create session
Creates a temporary session token that allows your end-users to import data through the SDK. Sessions are time-limited and tied to specific end-user identifiers for compliance.
Authentication:
- Requires Secret Key (server-to-server only)
Session flow:
- Your backend calls this endpoint with end-user information
- You receive a session token
- Pass the token to your frontend SDK
- End-user can now import data using that token
Expiration:
- Default: 1 hour
- Maximum: 24 hours
- Specify custom duration with
expiresIn(in seconds)
End-user identification:
endUserIdis required for tracking and complianceendUserEmailis optional but recommended- These identifiers are used for GDPR/CCPA data deletion requests
templateId?string
Format
uuidendUserIdstring
Length
1 <= length <= 255endUserEmail?string
Format
emailendUserIp?string
Match
^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$|^[0-9a-fA-F:]+$expiresIn?integer
Range
60 <= value <= 86400metadata?Recordstringunknown
Construct a type with a set of properties K of type T
Empty Object
Response Body
curl -X POST "https://api.ivandt.com/v1/sessions" \ -H "Content-Type: application/json" \ -d '{ "endUserId": "string" }'{
"sessionToken": "string",
"expiresAt": "string"
}