1. HMAC Authentication
Calven
  • Overview
  • Key Access Levels
  • Basic Authentication Overview
  • HMAC Authentication Overview
  • SDKs
  • Calven Data Models
  • Changelog
  • HMAC Authentication
    • Generate a token with an API key and HMAC
      POST
    • Generate a token with an API key and client secret
      POST
  • Presence
    • Presence Overview
    • Submit presence events with BASIC auth
      POST
    • Submit presence events
      POST
  • Occupancy
    • Occupancy Overview
    • Submit occupancy events
      POST
  • Time off
    • Submit time off updates
      POST
  • Access Credentials
    • Submit access credentials
      POST
  • Warehouse - Basic Auth
    • Warehouse Overview
    • Users
      GET
    • Groups
      GET
    • Locations
      GET
    • Desks
      GET
    • Bookings & Attendance
      GET
    • Presence Details
      GET
    • User Actions Log
      GET
  • Warehouse - HMAC Auth
    • Warehouse Overview
    • Users
    • Groups
    • Locations
    • Desks
    • Bookings & Attendance
    • Presence
    • User Actions Log
  • Hierarchy Information
    • Org Hierarchy Information Overview
    • Submit group hierarchy relationships
    • Submit group hierarchy relationships with Basic Auth
  • DirectoryManagement
    • User Attributes Overview
    • Write directory user attributes
    • Write directory user attributes with Basic Auth
  • Schemas
    • Schemas
      • DWDesksResponseDto
      • DMGroupRelationshipDto
      • PresenceEventDto
      • DWGroupsResponseDto
      • LeaveRequestBody
      • CreatePresenceEventDto
      • TimeoffRequestBody
      • TimeOffEvent
      • EventResultDto
      • TimeoffResponse
      • ResultCodes
      • TimeoffEventResponse
      • CreatePresenceEventResponseDto
      • OccupancyEventDto
      • CreateOccupancyEventDto
      • CreateOccupancyEventResponseDto
      • AuthRequestDto
      • AuthResponseDto
      • OAuthRequestDto
      • OAuthResponseDto
      • AccessCredentialUpdateResultCodes
      • AccessCredentialUpdateResult
      • AccessCredentialUpdateResponse
      • AccessCredential
      • AccessCredentialUpdate
      • AccessCredentialUpdateRequest
      • DWChangeLogUserResponseDto
      • DWUserBookingAttendanceResponseDto
      • DWPresenceResponseDto
      • DWUsersResponseDto
      • DWLocationsResponseDto
    • DMPostUserAttributesRecordDto
    • DMPostUserAttributesBodyDto
    • DMPostUserAttributesRecordResponseDto
    • DMPostUserAttributesResponseDto
  1. HMAC Authentication

Generate a token with an API key and HMAC

POST
/v1/auth
Generate a token with an API key and HMACSHA256.

Request

Body Params application/json

Example

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.calven.com/v1/auth' \
--header 'Content-Type: application/json' \
--data '{
    "apiKey": "string",
    "timestamp": 1711062317,
    "hash": "string"
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "authenticated": true,
    "message": "string",
    "token": "string",
    "expiration": 0
}
🟠400400
🟠401Payload when auth header is missing or invalid
Modified at 2025-04-03 13:54:20
Previous
Changelog
Next
Generate a token with an API key and client secret
Built with