Calven Developer Docs
    • Overview
    • Access Control
    • Basic Authentication
    • HMAC Authentication
    • SDKs
    • Calven Data Models
    • Changelog
    • 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
        POST
      • Submit presence events (Basic auth)
        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 API (Basic Auth)
      • Users (Basic auth)
        GET
      • Groups (Basic auth)
        GET
      • Locations (Basic auth)
        GET
      • Desks (Basic auth)
        GET
      • Bookings & Attendance (Basic auth)
        GET
      • Presence (Basic auth)
        GET
      • User Actions Log (Basic auth)
        GET
      • Events (Basic auth)
        GET
    • Warehouse - HMAC Auth
      • Warehouse API (HMAC Auth)
      • Users
      • Groups
      • Locations
      • Desks
      • Bookings & Attendance
      • Presence
      • User Actions Log
      • Events
    • Hierarchy Information
      • Org Hierarchy Information Overview
      • Submit group hierarchy relationships
      • Submit group hierarchy relationships (Basic auth)
    • User Attributes
      • User Attributes Overview
      • Write directory user attributes
      • Write directory user attributes (Basic auth)
    • Visitor Management
      • Submit visitor arrival events
      • Submit visitor arrival events (Basic auth)
    • Parking
      • Retrieve parking bookings
      • Retrieve parking bookings (Basic auth)
    • Schemas
      • Schemas
      • DWEventsResponseDto

    Basic Authentication Overview

    To allow systems that cannot support a two-step auth process to report presence, the /basic endpoints accept basic authentication.
    A specific API key that is enabled for basic authentication is required. This API key cannot be used with the /v1/auth endpoints.
    Contact Calven support to request a basic auth API key.
    Basic authentication sends a header holding the username and password, joined by a colon and encoded as base64:
    Authorization: Basic base64({userName}:{password})
    On Calven endpoints, use the apiKeyId as the username and the apiSecret as the password. Join them with a colon, encode the result as base64, and send:
    Authorization: Basic base64({apiKeyId}:{apiSecret})
    An apiKeyId of abc123 and an apiSecret of s3cret encode to YWJjMTIzOnMzY3JldA==, so the header reads:
    Authorization: Basic YWJjMTIzOnMzY3JldA==
    Most HTTP clients build this header for you. In curl, pass the pair to -u and curl encodes it:
    Modified at 2026-09-01 04:19:58
    Previous
    Access Control
    Next
    HMAC Authentication
    Built with