Skip to main content
Session tokens are used to authenticate embedded applications and third-party integrations.

​
Create Session (OAuth2)

POST /api/v1/sessions

Used by third-party backend services using Telzino Account API Keys.

​
Request Body

FieldTypeRequiredDescription
profile_idstring (UUID)YesConfiguration profile ID
user_idstringNoOptional external user identifier

​
Example Request

curl -X POST "https://api.telzino.com/api/v1/sessions" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "123e4567-e89b-12d3-a456-426614174000",
    "user_id": "1234-5678"
  }'

​
Example Response

{
  "token": "abc123xyz",
  "expires_at": "2025-07-02T18:30:00Z"
}

​
Create Session (NetSapiens)

POST /api/v1/sessions/netsapiens

Used by NetSapiens frontend JavaScript for direct integration.

​
Headers

HeaderTypeRequiredDescription
X-NS-Api-KeystringYesNetSapiens API token from OAuth

​
Request Body

FieldTypeRequiredDescription
profile_idstring (UUID)YesConfiguration profile ID
claim_idstring (UUID)YesNetSapiens user base claim ID
user_idstringNoOptional external user identifier

​
Example Request

curl -X POST "https://api.telzino.com/api/v1/sessions/netsapiens" \
  -H "X-NS-Api-Key: ns_api_token_from_netsapiens_oauth" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "123e4567-e89b-12d3-a456-426614174000",
    "claim_id": "9f14c1a4-02f0-4ad0-b5f4-08c1f8f9b3a2"
  }'

​
Example Response

{
  "token": "abc123xyz",
  "expires_at": "2025-07-02T18:30:00Z"
}

​
Error Responses

CodeDescription
400Bad request - missing required fields
401Unauthorized - invalid API key or authorization
404Profile or claim not found
500Internal server error