Ivandt logo

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:

  1. Your backend calls this endpoint with end-user information
  2. You receive a session token
  3. Pass the token to your frontend SDK
  4. 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:

  • endUserId is required for tracking and compliance
  • endUserEmail is optional but recommended
  • These identifiers are used for GDPR/CCPA data deletion requests
POST
/sessions
templateId?string
Formatuuid
endUserIdstring
Length1 <= length <= 255
endUserEmail?string
Formatemail
endUserIp?string
Match^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$|^[0-9a-fA-F:]+$
expiresIn?integer
Range60 <= value <= 86400
metadata?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"
}