Humaans

Humaans is a London-headquartered modern HRIS (Human Resources Information System) for fast-growing, distributed teams. The platform combines a best-in-class system of record — employee directory, documents, time off, timesheets, compensation, equipment, locations, custom fields and tables, performance reviews, and onboarding/offboarding workflows — with the Athena agentic AI platform and an AI Companion that automate administrative HR work. Humaans exposes a comprehensive REST API at app.humaans.io/api with Bearer token authentication, OAuth-style scopes, $limit/$skip pagination, rich filter operators, and HMAC SHA-256 signed webhooks. The API spans 70+ documented resource categories including People, Companies, Compensations, Bank Accounts, Documents, Time Away (entries, allocations, policies, types), Equipment, Job Roles, Locations, Custom Fields and Values, Performance, Timesheet entries and submissions, Webhooks, Audit Events, and Working Patterns. Humaans ships pre-built integrations across payroll, identity, compliance, finance, ATS, performance, benefits, learning, and automation, plus a Zapier connector and an Apideck HRIS unified-API binding. Trusted by global teams across 300+ locations and rated 4.8/5 on G2.

1 APIs 20 Features

HRHRISHuman ResourcesPeople OperationsPeople AnalyticsOnboardingOffboardingPerformance ManagementTime OffCompensationWorkflow AutomationAI CompanionAgentic AIUKLondon

APIs

Humaans API

REST API for the Humaans HRIS exposing People, Companies, Compensations, Bank Accounts, Documents, Time Away (entries, allocations, policies, types), Equipment, Job Roles, Locat...

Collections

Humaans API

OPEN

Features

REST HRIS API with consistent resource-oriented URLs, JSON in / JSON out, and standard HTTP verbs and status codes

Bearer token authentication with OAuth-style scopes (public:read, private:read, private:write, compensations:read/write, documents:read/write, webhooks:manage)

Role-based access control (Owner, Admin, Finance, Tech, Manager, User) reflected in API access

Pagination via $limit (default 100, max 250) and $skip

Rich filtering operators ($in, $nin, $gt, $gte, $lt, $lte, $or) on most collections

70+ documented resource categories — People, Companies, Compensations, Bank Accounts, Documents, Document Folders, Document Types, Identity Documents

Time Away — entries, allocations, types, policies, and accruals

Equipment, Job Roles, Locations, Custom Fields, Custom Values, Working Patterns

Performance — reviews, cycles, templates, ratings (mostly read)

Timesheet entries and submissions with full CRUD

HMAC SHA-256 signed webhooks with exponential backoff retry and auto-disable after 5 days of failures

Read-only Audit Events stream for compliance and SIEM integration

Pre-built integrations across Payroll (Remote, Oyster, Papaya Global, Symmetrical, Payap, PayCaptain, Salary), Identity (Okta, JumpCloud, Microsoft Entra ID, Google SSO, SAML), Compliance (Vanta, Drata, Secureframe), Finance (Carta, Pulley, Pleo, Spendesk, Moss, Ramp, Pave, Ravio, Figures, Ledgy, Mesh Payments, Cledara), ATS (Greenhouse, Lever, Workable, Ashby, Teamtailor, Gem, Pinpoint, Manatal), Performance (Lattice, CultureAmp, Leapsome, Workvivo, Eletive, Officevibe, Frankli, Appraisd), Calendar/Comms (Google Calendar, Slack), eSignature (Docusign, Contractbook), Benefits (Ben, Assembly, Bonusly, Goody, Kota, Happl, CakeDrop), Learning (Sana Labs, WorkRamp, Ethena), Automation (Zapier), People Analytics (ChartHop, Insightful)

Native Apideck HRIS unified-API connector for Humaans

Athena agentic AI platform plus AI Companion add-on for natural-language HR queries

Workflow automation, onboarding/offboarding sequences, and dynamic databases (custom data tables)

300+ global locations supported with country-specific localisation

iOS and Android mobile apps

SOC 2, ISO 27001, and GDPR-aligned controls; Vanta/Drata/Secureframe automation integrations

99.9% uptime SLA on the Enterprise plan

Resources

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Humaans API
  version: '1.0'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: People
    type: folder
  items:
  - info:
      name: List People
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/people
      params:
      - name: $limit
        value: ''
        type: query
        description: Maximum results per page (default 100, max 250)
      - name: $skip
        value: ''
        type: query
        description: Number of results to skip for pagination
    docs: List People
  - info:
      name: Create Person
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/people
      body:
        type: json
        data: '{}'
    docs: Create Person
  - info:
      name: Retrieve Person
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/people/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Person
  - info:
      name: Update Person
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/people/:id
      params:
      - name: id
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Update Person
  - info:
      name: Delete Person
      type: http
    http:
      method: DELETE
      url: https://app.humaans.io/api/people/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete Person
- info:
    name: Companies
    type: folder
  items:
  - info:
      name: List Companies
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/companies
    docs: List Companies
  - info:
      name: Retrieve Company
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/companies/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Company
  - info:
      name: Update Company
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/companies/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update Company
- info:
    name: Compensations
    type: folder
  items:
  - info:
      name: List Compensations
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/compensations
    docs: List Compensations
  - info:
      name: Create Compensation
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/compensations
    docs: Create Compensation
  - info:
      name: Retrieve Compensation
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/compensations/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Compensation
  - info:
      name: Update Compensation
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/compensations/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update Compensation
  - info:
      name: Delete Compensation
      type: http
    http:
      method: DELETE
      url: https://app.humaans.io/api/compensations/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete Compensation
- info:
    name: Bank Accounts
    type: folder
  items:
  - info:
      name: List Bank Accounts
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/bank-accounts
    docs: List Bank Accounts
  - info:
      name: Create Bank Account
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/bank-accounts
    docs: Create Bank Account
  - info:
      name: Retrieve Bank Account
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/bank-accounts/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Bank Account
  - info:
      name: Update Bank Account
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/bank-accounts/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update Bank Account
  - info:
      name: Delete Bank Account
      type: http
    http:
      method: DELETE
      url: https://app.humaans.io/api/bank-accounts/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete Bank Account
- info:
    name: Documents
    type: folder
  items:
  - info:
      name: List Documents
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/documents
    docs: List Documents
  - info:
      name: Create Document
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/documents
    docs: Create Document
  - info:
      name: Retrieve Document
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/documents/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Document
  - info:
      name: Update Document
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/documents/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update Document
  - info:
      name: Delete Document
      type: http
    http:
      method: DELETE
      url: https://app.humaans.io/api/documents/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete Document
- info:
    name: Time Away
    type: folder
  items:
  - info:
      name: List Time Away
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/time-away
    docs: List Time Away
  - info:
      name: Create Time Away
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/time-away
    docs: Create Time Away
  - info:
      name: Retrieve Time Away
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/time-away/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Time Away
  - info:
      name: Update Time Away
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/time-away/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update Time Away
  - info:
      name: Delete Time Away
      type: http
    http:
      method: DELETE
      url: https://app.humaans.io/api/time-away/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete Time Away
  - info:
      name: List Time Away Types
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/time-away-types
    docs: List Time Away Types
  - info:
      name: List Time Away Policies
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/time-away-policies
    docs: List Time Away Policies
  - info:
      name: List Time Away Allocations
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/time-away-allocations
    docs: List Time Away Allocations
- info:
    name: Equipment
    type: folder
  items:
  - info:
      name: List Equipment
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/equipment
    docs: List Equipment
  - info:
      name: Create Equipment
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/equipment
    docs: Create Equipment
  - info:
      name: Retrieve Equipment
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/equipment/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Equipment
  - info:
      name: Update Equipment
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/equipment/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update Equipment
  - info:
      name: Delete Equipment
      type: http
    http:
      method: DELETE
      url: https://app.humaans.io/api/equipment/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete Equipment
- info:
    name: Job Roles
    type: folder
  items:
  - info:
      name: List Job Roles
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/job-roles
    docs: List Job Roles
  - info:
      name: Create Job Role
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/job-roles
    docs: Create Job Role
  - info:
      name: Retrieve Job Role
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/job-roles/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Job Role
  - info:
      name: Update Job Role
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/job-roles/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update Job Role
  - info:
      name: Delete Job Role
      type: http
    http:
      method: DELETE
      url: https://app.humaans.io/api/job-roles/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete Job Role
- info:
    name: Locations
    type: folder
  items:
  - info:
      name: List Locations
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/locations
    docs: List Locations
  - info:
      name: Create Location
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/locations
    docs: Create Location
  - info:
      name: Retrieve Location
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/locations/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Location
  - info:
      name: Update Location
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/locations/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update Location
  - info:
      name: Delete Location
      type: http
    http:
      method: DELETE
      url: https://app.humaans.io/api/locations/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete Location
- info:
    name: Custom Fields
    type: folder
  items:
  - info:
      name: List Custom Fields
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/custom-fields
    docs: List Custom Fields
  - info:
      name: Create Custom Field
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/custom-fields
    docs: Create Custom Field
  - info:
      name: List Custom Values
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/custom-values
    docs: List Custom Values
  - info:
      name: Create Custom Value
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/custom-values
    docs: Create Custom Value
- info:
    name: Performance
    type: folder
  items:
  - info:
      name: List Performance Reviews
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/performance-reviews
    docs: List Performance Reviews
  - info:
      name: List Performance Cycles
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/performance-cycles
    docs: List Performance Cycles
  - info:
      name: List Performance Templates
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/performance-templates
    docs: List Performance Templates
- info:
    name: Timesheet
    type: folder
  items:
  - info:
      name: List Timesheet Entries
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/timesheet-entries
    docs: List Timesheet Entries
  - info:
      name: Create Timesheet Entry
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/timesheet-entries
    docs: Create Timesheet Entry
  - info:
      name: List Timesheet Submissions
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/timesheet-submissions
    docs: List Timesheet Submissions
- info:
    name: Webhooks
    type: folder
  items:
  - info:
      name: List Webhooks
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/webhooks
    docs: List Webhooks
  - info:
      name: Create Webhook
      type: http
    http:
      method: POST
      url: https://app.humaans.io/api/webhooks
    docs: Create Webhook
  - info:
      name: Retrieve Webhook
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/webhooks/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Retrieve Webhook
  - info:
      name: Update Webhook
      type: http
    http:
      method: PATCH
      url: https://app.humaans.io/api/webhooks/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Update Webhook
  - info:
      name: Delete Webhook
      type: http
    http:
      method: DELETE
      url: https://app.humaans.io/api/webhooks/:id
      params:
      - name: id
        value: ''
        type: path
    docs: Delete Webhook
- info:
    name: Audit Events
    type: folder
  items:
  - info:
      name: List Audit Events
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/audit-events
    docs: List Audit Events
- info:
    name: Working Patterns
    type: folder
  items:
  - info:
      name: List Working Patterns
      type: http
    http:
      method: GET
      url: https://app.humaans.io/api/working-patterns
    docs: List Working Patterns
bundled: true