Humaans

HR platform for managing people data, time away, timesheets, compensation, and documents across your organisation.

10 triggers18 searches26 actionsInstant (webhooks)Auth: API key

AI-assisted documentation22 min read

This documentation is compiled from our integration source code, internal specs for Humaans, its official API documentation and anonymized requests logs we collect from our support team[2].

Open Humaans on WEXTL →

Requirements

Humaans requires an active account and an API access token from your account settings to connect — both are set up on its own site.[3]

Get your Humaans credentials

API Access TokenpasswordRequired
Enter your API access token. You can generate one in your account settings under API Access Tokens. Ensure the token has the required scopes for the actions you want to perform.
[1]

Connect Humaans in WEXTL

Log in to your WEXTL account, add the Humaans node module to your workflow, and click Create new credential.
Instant triggers use webhooks — click Create a webhook first when adding one, then create the credential.
Optional: In the Credential name field, enter a name for the credential.
Enter the authentication credentials you copied from your Humaans account, or follow the on-screen instructions to create the credential.
If prompted, authenticate your account and confirm access.
If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Connecting Humaans to WEXTL® — Video slide demonstrates how to integrate Humaans in the WEXTL visual workflow builder.[4]

Video slide demonstrates how to integrate Humaans in the WEXTL visual workflow builder.[4]

Notes

Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →

Humaans node modules

The list below is a reference of every Humaans node module the integration supports. You will be able to pick any of them on the workflow canvas while building automations.

Browse every Humaans node module below — each one opens to show its input parameters, outputs, and connection requirements.

Watch CompaniesTrigger

Output fields[3]

Field	Type
Company ID	text
Name	text
Domains	array
Trial end date	date
Status	text
Payment status	text
Created at	date
Updated at	date
Is timesheet enabled	boolean
Logo	object
ID	text
Filename	text
Variants	object
Autogenerate employee ID filters	array

Watch CompensationsTrigger

Output fields[3]

Field	Type
Compensation ID	text
Person ID	text
Compensation type ID	text
Amount	text
Currency	text
Period	text
Note	text
Effective date	date
End date	date
End reason	text
Created at	date
Updated at	date

Watch Custom FieldsTrigger

Output fields[3]

Field	Type
Custom Field ID	text
Company ID	text
Name	text
Section	text
Resource ID	text
Type	text
Config	text
Created at	date
Updated at	date

Watch Custom ValuesTrigger

Output fields[3]

Field	Type
custom Value ID	text
Person ID	text
Custom field ID	text
Resource ID	text
Value	text
Created at	date
Updated at	date

Watch DocumentsTrigger

Output fields[3]

Field	Type
Documents ID	text
Company ID	text
Person ID	text
Name	text
Link	text
File ID	text
File	object
ID	text
URL	text
Filename	text
Source	text
Source ID	text
Issue date	text
Created at	date
Updated at	date

Watch EventsTrigger

Output fields[3]

Field	Type
User ID	number
Email address	email
Name	text
Date created	date

Watch PeopleTrigger

Output fields[3]

Field	Type
People ID	text
Company ID	text
Space ID	text
First name	text
Middle name	text
Last name	text
Preferred name	text
Email	text
Location ID	text
Remote city	text
Remote region code	text
Remote country code	text
Remote timezone	text
Personal email	text
Phone number	text
Formatted phone number	text
Personal phone number	text
Formatted personal phone number	text
Gender	text
Birthday	text

46other output fields

Watch Time AwayTrigger

Output fields[3]

Field	Type
Time Away ID	text
Person ID	text
Start time	text
End time	text
Start date	date
Start period	text
End date	date
End period	text
Time away type ID	text
Name	text
Is time off	boolean
Working from location ID	text
Note	text
Breakdown	array
Days	number
Request status	text
Requested by	text
Reviewed by	text
Reviewed at	date
Review note	text

5other output fields

Watch Timesheet EntriesTrigger

Output fields[3]

Field	Type
Timesheet Entry ID	text
Company ID	text
Name	text
Emoji	text
Emoji label	text
Category	text
Base type	text
Created at	date
Updated at	date

Watch Timesheet SubmissionTrigger

Output fields[3]

Field	Type
Timesheet Submission ID	text
Person ID	text
Start date	date
End date	date
Status	text
Submitted at	date
Reviewed by	text
Reviewed at	date
Changes requested	text
Duration as time	object
Hours	number
Minutes	number
Duration as days	number
Created at	date
Updated at	date

Get a CompanyAction

Input fields[3]

Field	Type
Company IDRequired	choice

Output fields[3]

Field	Type
Company ID	text
Name	text
Domains	array
Trial end date	date
Status	text
Payment status	text
Created at	date
Updated at	date
Is timesheet enabled	boolean
Logo	object
ID	text
Filename	text
Variants	object
Autogenerate employee ID filters	array

Get a CompensationAction

Input fields[3]

Field	Type
Compensation IDRequired	choice

Output fields[3]

Field	Type
Compensation ID	text
Person ID	text
Compensation type ID	text
Amount	text
Currency	text
Period	text
Note	text
Effective date	date
End date	date
End reason	text
Created at	date
Updated at	date

Get a Custom FieldAction

Input fields[3]

Field	Type
Custom Field IDRequired	choice

Output fields[3]

Field	Type
Custom Field ID	text
Company ID	text
Name	text
Section	text
Resource ID	text
Type	text
Config	text
Created at	date
Updated at	date

Get a Custom ValueAction

Input fields[3]

Field	Type
Custom Value IDRequired	choice

Output fields[3]

Field	Type
ID	text
Person ID	text
Custom field ID	text
Resource ID	text
Value	text
Created at	date
Updated at	date

Get a DocumentAction

Input fields[3]

Field	Type
Document IDRequired	choice

Output fields[3]

Field	Type
Documents ID	text
Company ID	text
Person ID	text
Name	text
Link	text
File ID	text
File	object
ID	text
URL	text
Filename	text
Source	text
Source ID	text
Issue date	date
Created at	date
Updated at	date

Get a PersonAction

Input fields[3]

Field	Type
Person IDRequired	choice

Output fields[3]

Field	Type
People ID	text
Company ID	text
Space ID	text
First name	text
Middle name	text
Last name	text
Preferred name	text
Email	text
Location ID	text
Remote city	text
Remote region code	text
Remote country code	text
Remote timezone	text
Personal email	text
Phone number	text
Formatted phone number	text
Personal phone number	text
Formatted personal phone number	text
Gender	text
Birthday	text

46other output fields

Get a Timesheet EntryAction

Input fields[3]

Field	Type
Timesheet Entry IDRequired	choice

Output fields[3]

Field	Type
Timesheet Entry ID	text
Company ID	text
Name	text
Emoji	text
Emoji label	text
Category	text
Base type	text
Created at	date
Updated at	date

Get a Timesheet SubmissionAction

Input fields[3]

Field	Type
Timesheet Submission IDRequired	choice

Output fields[3]

Field	Type
Timesheet Submission ID	text
Person ID	text
Start date	date
End date	date
Status	text
Submitted at	date
Reviewed by	text
Reviewed at	date
Changes requested	text
Duration as time	object
Hours	number
Minutes	number
Duration as days	number
Created at	date
Updated at	date

Get Time AwayAction

Input fields[3]

Field	Type
Time Away IDRequired	choice

Output fields[3]

Field	Type
Time Away ID	text
Person ID	text
Start time	text
End time	text
Start date	date
Start period	text
End date	date
End period	text
Time away type ID	text
Name	text
Is time off	boolean
Working from location ID	text
Note	text
Breakdown	array
Days	number
Request status	text
Requested by	text
Reviewed by	text
Reviewed at	date
Review note	text

5other output fields

List CompaniesSearch

Input fields[3]

Field	Type
Maximum Number of Companies	number

Output fields[3]

Field	Type
Company ID	text
Name	text
Domains	array
Trial end date	date
Status	text
Payment status	text
Created at	date
Updated at	date
Is timesheet enabled	boolean
Logo	object
ID	text
Filename	text
Variants	object
Autogenerate employee ID filters	array

List CompensationsSearch

Input fields[3]

Field	Type
Person ID	choice
Compensation Type ID	choice
As Of Date	date
Maximum Number of Compensations	number

Output fields[3]

Field	Type
Compensation ID	text
Person ID	text
Compensation type ID	text
Amount	text
Currency	text
Period	text
Note	text
Effective date	date
End date	date
End reason	text
Created at	date
Updated at	date

List Custom FieldsSearch

Input fields[3]

Field	Type
Section	choice
Field Type	choice
Custom Field ID	choice
Maximum Number of Custom Fields	number

Output fields[3]

Field	Type
Custom Field ID	text
Company ID	text
Name	text
Section	text
Resource ID	text
Type	text
Config	text
Created at	date
Updated at	date

List Custom ValuesSearch

Input fields[3]

Field	Type
Person ID	choice
Custom Field ID	choice
Resource ID	choice
Created After	date
Created On or After	date
Created Before	date
Created On or Before	date
Updated After	date
Updated On or After	date
Updated Before	date
Updated On or Before	date
OR Filters	array
Maximum Number of Custom Values	number

Output fields[3]

Field	Type
custom Value ID	text
Person ID	text
Custom field ID	text
Resource ID	text
Value	text
Created at	date
Updated at	date

List DocumentsSearch

Input fields[3]

Field	Type
Person ID	choice
OR Filters	array
Maximum Number of Documents	number

Output fields[3]

Field	Type
Documents ID	text
Company ID	text
Person ID	text
Name	text
Link	text
File ID	text
File	object
ID	text
URL	text
Filename	text
Source	text
Source ID	text
Issue date	text
Created at	date
Updated at	date

List PeopleSearch

Input fields[3]

Field	Type
First Name	text
Last Name	text
Preferred Name	text
Work Email	email
Personal Email	text
Space ID	choice
Team	text
Status	choice
Employment Start Date After	date
Employment Start Date On or After	date
Employment Start Date Before	date
Employment Start Date On or Before	date
Employment End Date After	date
Employment End Date On or After	date
Employment End Date Before	date
Employment End Date On or Before	date
First Working Day After	date
First Working Day On or After	date
First Working Day Before	date
First Working Day On or Before	date

18other input fields

Output fields[3]

Field	Type
People ID	text
Company ID	text
Space ID	text
First name	text
Middle name	text
Last name	text
Preferred name	text
Email	text
Location ID	text
Remote city	text
Remote region code	text
Remote country code	text
Remote timezone	text
Personal email	text
Phone number	text
Formatted phone number	text
Personal phone number	text
Formatted personal phone number	text
Gender	text
Birthday	text

46other output fields

List Time AwaySearch

Input fields[3]

Field	Type
Person ID	choice
Person Status	choice
Time Away Type ID	choice
Request Status	choice
Include Deleted Entries	boolean
Deleted Entries Only	boolean
Start Date After	date
Start Date On or After	date
Start Date Before	date
Start Date On or Before	date
End Date After	date
End Date On or After	date
End Date Before	date
End Date On or Before	date
Updated After	date
Updated On or After	date
Updated Before	date
Updated On or Before	date
Sort by Start Date	choice
Sort by End Date	choice

2other input fields

Output fields[3]

Field	Type
Time Away ID	text
Person ID	text
Start time	text
End time	text
Start date	date
Start period	text
End date	date
End period	text
Time away type ID	text
Name	text
Is time off	boolean
Working from location ID	text
Note	text
Breakdown	array
Days	number
Request status	text
Requested by	text
Reviewed by	text
Reviewed at	date
Review note	text

5other output fields

List Timesheet EntriesSearch

Input fields[3]

Field	Type
Person ID	choice
End Time	text
Date After	date
Date On or After	date
Date Before	date
Date On or Before	date
Maximum Number of Entries	number

Output fields[3]

Field	Type
Timesheet Entry ID	text
Company ID	text
Name	text
Emoji	text
Emoji label	text
Category	text
Base type	text
Created at	date
Updated at	date

List Timesheet SubmissionsSearch

Input fields[3]

Field	Type
Person ID	choice
Start Date	date
Maximum Number of Entries	number

Output fields[3]

Field	Type
Timesheet Submission ID	text
Person ID	text
Start date	date
End date	date
Status	text
Submitted at	date
Reviewed by	text
Reviewed at	date
Changes requested	text
Duration as time	object
Hours	number
Minutes	number
Duration as days	number
Created at	date
Updated at	date

Create a Custom FieldAction

Input fields[3]

Field	Type
Field NameRequired	text
SectionRequired	choice
Resource ID	choice
Field TypeRequired	choice
Configuration	object
Autocomplete	boolean
Choices	array

Output fields[3]

Field	Type
Custom Field ID	text
Company ID	text
Name	text
Section	text
Resource ID	text
Type	text
Config	text
Created at	date
Updated at	date

Create a DocumentAction

Input fields[3]

Field	Type
Person ID	choice
Document NameRequired	text
Document Type ID	choice
Folder ID	choice
Document Link	text
File ID	choice
Issue Date	date
Document Type	text

Output fields[3]

Field	Type
Documents ID	text
Company ID	text
Person ID	text
Name	text
Link	text
File ID	text
File	object
ID	text
URL	text
Filename	text
Source	text
Source ID	text
Issue date	date
Created at	date
Updated at	date

Create a PersonAction

Input fields[3]

Field	Type
First NameRequired	text
Middle Name	text
Last NameRequired	text
Preferred Name	text
Pronouns	text
Work Email	email
Personal Email	text
Work Phone Number	text
Personal Phone Number	text
Gender	text
Birthday	date
Hide Birthday	boolean
Profile Photo ID	choice
Nationality	text
Nationalities	array
NationalityRequired	text
Spoken Languages	array
LanguageRequired	text
Dietary Preference	choice
Food Allergies	array
Food AllergyRequired	text
Address	text
City	text

13other input fields

Output fields[3]

Field	Type
People ID	text
Company ID	text
Space ID	text
First name	text
Middle name	text
Last name	text
Preferred name	text
Email	text
Location ID	text
Remote city	text
Remote region code	text
Remote country code	text
Remote timezone	text
Personal email	text
Phone number	text
Formatted phone number	text
Personal phone number	text
Formatted personal phone number	text
Gender	text
Birthday	text

46other output fields

Create a Timesheet SubmissionAction

Input fields[3]

Field	Type
Person IDRequired	choice
Start DateRequired	date

Output fields[3]

Field	Type
Timesheet Submission ID	text
Person ID	text
Start date	date
End date	date
Status	text
Submitted at	date
Reviewed by	text
Reviewed at	date
Changes requested	text
Duration as time	object
Hours	number
Minutes	number
Duration as days	number
Created at	date
Updated at	date

Create CompensationAction

Input fields[3]

Field	Type
Person IDRequired	choice
Compensation Type IDRequired	choice
AmountRequired	text
Currency	text
PeriodRequired	choice
Note	text
Effective DateRequired	date
End Date	date
End Reason	text

Output fields[3]

Field	Type
Compensation ID	text
Person ID	text
Compensation type ID	text
Amount	text
Currency	text
Period	text
Note	text
Effective date	date
End date	date
End reason	text
Created at	date
Updated at	date

Create Custom ValueAction

Input fields[3]

Field	Type
Person IDRequired	choice
Custom Field IDRequired	choice
Resource ID	choice
ValueRequired	text

Output fields[3]

Field	Type
Custom Value ID	text
Person ID	text
Custom field ID	text
Resource ID	text
Value	text
Created at	date
Updated at	date

Create Time AwayAction

Input fields[3]

Field	Type
Person IDRequired	choice
Start Time	text
End Time	text
Start DateRequired	date
End DateRequired	date
Start Period	choice
End Period	choice
Time Away Type IDRequired	choice
Working From Location ID	text
Note	text
Request Status	choice
Review Note	text

Output fields[3]

Field	Type
Time Away ID	text
Person ID	text
Start time	text
End time	text
Start date	date
Start period	text
End date	date
End period	text
Time away type ID	text
Name	text
Is time off	boolean
Working from location ID	text
Note	text
Breakdown	array
Days	number
Request status	text
Requested by	text
Reviewed by	text
Reviewed at	date
Review note	text

5other output fields

Create Timesheet EntryAction

Input fields[3]

Field	Type
Person IDRequired	choice
DateRequired	date
Start TimeRequired	text
End Time	text

Output fields[3]

Field	Type
Timesheet Entry ID	text
Company ID	text
Name	text
Emoji	text
Emoji label	text
Category	text
Base type	text
Created at	date
Updated at	date

Delete a CompensationAction

Input fields[3]

Field	Type
Compensation IDRequired	choice

Output fields[3]

Field	Type
Compensation ID	text
Deleted	boolean

Delete a DocumentAction

Input fields[3]

Field	Type
Document IDRequired	choice

Output fields[3]

Field	Type
Document ID	text
Deleted	boolean

Delete a PersonAction

Input fields[3]

Field	Type
Person IDRequired	choice

Output fields[3]

Field	Type
Person ID	text
Deleted	boolean

Delete a Timesheet EntryAction

Input fields[3]

Field	Type
Timesheet Entry IDRequired	choice

Delete a Timesheet SubmissionAction

Input fields[3]

Field	Type
Timesheet Submission IDRequired	choice

Output fields[3]

Field	Type
Timesheet Submission ID	text
Deleted	boolean

Delete Custom FieldsAction

Input fields[3]

Field	Type
Custom Field IDRequired	choice

Output fields[3]

Field	Type
Custom Field ID	text
Deleted	boolean

Delete Custom ValueAction

Input fields[3]

Field	Type
Custom Value IDRequired	choice

Output fields[3]

Field	Type
Custom Value ID	text
Deleted	boolean

Delete Time AwayAction

Input fields[3]

Field	Type
Time Away IDRequired	choice

Output fields[3]

Field	Type
Time Away ID	text
Deleted	boolean

Make An API Calluniversal

Input fields[3]

Field	Type
URLRequired	text
MethodRequired	choice
Headers	array
Header	object
Query String	array
Parameter	object
Body	text

Output fields[3]

Field	Type
Body	text
Headers	object
Status code	number

Update a CompanyAction

Input fields[3]

Field	Type
Company IDRequired	choice
Company Name	text
Enable Timesheets	boolean
Automatically Generate Employee IDs	boolean
Automatically Generate Employee IDs for New Hires	boolean
Next Employee ID	text
Employee ID Generation Filters	array

Output fields[3]

Field	Type
Company ID	text
Name	text
Domains	array
Trial end date	date
Status	text
Payment status	text
Created at	date
Updated at	date
Is timesheet enabled	boolean
Logo	object
ID	text
Filename	text
Variants	object
Autogenerate employee ID filters	array

Update a CompensationAction

Input fields[3]

Field	Type
Compensation IDRequired	choice
Compensation Type ID	choice
Amount	text
Currency	text
Period	choice
Note	text
Effective Date	date
End Date	date
End Reason	text

Output fields[3]

Field	Type
Compensation ID	text
Person ID	text
Compensation type ID	text
Amount	text
Currency	text
Period	text
Note	text
Effective date	date
End date	date
End reason	text
Created at	date
Updated at	date

Update a DocumentAction

Input fields[3]

Field	Type
Document IDRequired	choice
Document Name	text
Document Type ID	choice
Folder ID	choice
Issue Date	date
Document Type	text

Output fields[3]

Field	Type
Documents ID	text
Company ID	text
Person ID	text
Name	text
Link	text
File ID	text
File	object
ID	text
URL	text
Filename	text
Source	text
Source ID	text
Issue date	date
Created at	date
Updated at	date

Update a PersonAction

Input fields[3]

Field	Type
Person IDRequired	choice
First Name	text
Middle Name	text
Last Name	text
Preferred Name	text
Pronouns	text
Work Email	email
Personal Email	email
Work Phone Number	text
Personal Phone Number	text
Gender	text
Birthday	date
Hide Birthday	boolean
Profile Photo ID	text
Nationality	text
Nationalities	array
NationalityRequired	text
Spoken Languages	array
LanguageRequired	text
Dietary Preference	choice
Food Allergies	array
Food AllergyRequired	text
Address	text

14other input fields

Update a Timesheet EntryAction

Input fields[3]

Field	Type
Timesheet Entry IDRequired	choice
Date	date
Start Time	text
End Time	text

Output fields[3]

Field	Type
Timesheet Entry ID	text
Company ID	text
Name	text
Emoji	text
Emoji label	text
Category	text
Base type	text
Created at	date
Updated at	date

Update a Timesheet SubmissionAction

Input fields[3]

Field	Type
Timesheet Submission IDRequired	choice
StatusRequired	choice
Changes Requested	text

Output fields[3]

Field	Type
Timesheet Submission ID	text
Person ID	text
Start date	date
End date	date
Status	text
Submitted at	date
Reviewed by	text
Reviewed at	date
Changes requested	text
Duration as time	object
Hours	number
Minutes	number
Duration as days	number
Created at	date
Updated at	date

Update Custom FieldsAction

Input fields[3]

Field	Type
Custom Field IDRequired	choice
Field Name	text
Configuration	object
Autocomplete	boolean
Choices	array

Output fields[3]

Field	Type
Custom Field ID	text
Company ID	text
Name	text
Section	text
Resource ID	text
Type	text
Config	text
Created at	date
Updated at	date

Update Custom ValueAction

Input fields[3]

Field	Type
Custom Value IDRequired	choice
Value	text

Output fields[3]

Field	Type
ID	text
Person ID	text
Custom field ID	text
Resource ID	text
Value	text
Created at	date
Updated at	date

Update Time AwayAction

Input fields[3]

Field	Type
Time Away IDRequired	choice
Start Time	text
End Time	text
Start Date	date
End Date	date
Start Period	choice
End Period	choice
Time Away Type ID	choice
Working From Location ID	text
Note	text
Request Status	choice
Review Note	text

Output fields[3]

Field	Type
Time Away ID	text
Person ID	text
Start time	text
End time	text
Start date	date
Start period	text
End date	date
End period	text
Time away type ID	text
Name	text
Is time off	boolean
Working from location ID	text
Note	text
Breakdown	array
Days	number
Request status	text
Requested by	text
Reviewed by	text
Reviewed at	date
Review note	text

5other output fields

Templates

Look for Humaans templates in the WEXTL template library.

Browse templates →

Explore alternative apps

More apps in HR category →

References

WEXTL® Humaans Source Code connector implementation.
Our users use cases and automations.
Official API Documentation for Humaans.
WEXTL® visual workflow builder data.

Last updated: Jul 21, 2026 15:22

How we write our apps documentation

How we compile these docs — sources, AI's role, and how we verify.