Requirements
Before you set up the credential, make sure you have an active FreshTeam account and an API access token from your account settings ready.[3]
Get your FreshTeam credentials
- Freshteam - Sub DomaintextRequired
You can take sub-domain from Freshteam URL, for example:
[1]mycompany.freshteam.com. You need to paste onlymycompany. - Freshteam - API KeypasswordRequired
To get your API key, log into your account, click your Profile Avatar (top-right), select API Key (or Profile Settings/API Settings), and then copy the key displayed there; you might need to complete a CAPTCHA for security, and the key allows integrations to access your data.
[1]
Connect FreshTeam in WEXTL
- Log in to your WEXTL account, add the FreshTeam node module to your workflow, and click Create new credential.
- Optional: In the Credential name field, enter a name for the credential.
- Enter the authentication credentials you copied from your FreshTeam 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 →

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 →
FreshTeam node modules
The list below is a reference of every FreshTeam node module the integration supports. You will be able to pick any of them on the workflow canvas while building automations.
Each FreshTeam node module below opens to reveal its input parameters, outputs, and connection requirements.
Watch Applicant Form Field ChangesTrigger
| Field | Type |
|---|---|
| ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Applicant form ID | number |
| Name | text |
| Field type | text |
| Label | text |
| Position | number |
| Default | boolean |
| Group label | text |
| Group position | text |
| Group name | text |
| External field | boolean |
| Recruiter field | boolean |
| Vendor field | boolean |
| Required in vendor form | boolean |
| Viewable by | text |
| Required in external form | boolean |
| Required in recruiter form | boolean |
Watch BranchesTrigger
| Field | Type |
|---|---|
| Branch ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
| State | text |
| City | text |
| Country code | text |
| Zip | text |
| Time zone | text |
| Currency | text |
| Language | text |
| Main office | boolean |
| Date format | text |
Watch Business UnitsTrigger
| Field | Type |
|---|---|
| Business Unit ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
| Description | text |
Watch DepartmentsTrigger
| Field | Type |
|---|---|
| Department ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
Watch EmployeesTrigger
| Field | Type |
|---|---|
| Employee ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Work numbers | array |
| Nick name | text |
| Date of birth | text |
| Gender | text |
| Address | object |
| Street | text |
| State | text |
| City | text |
| Country code | text |
| Zip code | text |
| Phone numbers | array |
| Communication address | object |
| Same as residential | boolean |
| Communication street | text |
| Communication state | text |
| Communication city | text |
| Communication country code | text |
| Communication zip code | text |
| Designation | text |
| Joining date | text |
| Branch ID | number |
| Team ID | number |
| Business unit ID | number |
| Sub department ID | text |
| Department ID | text |
| Reporting to ID | text |
| Hr incharge ID | text |
Watch Job PostingsTrigger
| Field | Type |
|---|---|
| Job Post ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Title | text |
| Description | text |
| Status | text |
| Salary | object |
| Min | text |
| Max | text |
| Currency | text |
| Applicant access type | text |
| Remote | boolean |
| Show pursue as career | boolean |
| Closing date | text |
| Experience | text |
| Type | text |
| Branch | object |
| ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
| State | text |
| City | text |
| Country code | text |
| Zip | text |
| Time zone | text |
| Department | object |
| ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
Watch LevelsTrigger
| Field | Type |
|---|---|
| Level ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
Watch Sub DepartmentsTrigger
| Field | Type |
|---|---|
| Sub Department ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
Watch TeamsTrigger
| Field | Type |
|---|---|
| Team ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
Watch Time OffsTrigger
| Field | Type |
|---|---|
| Time Off ID | number |
| Created at | date |
| Updated at | date |
| User ID | number |
| Start date | date |
| End date | date |
| Status | text |
| Leave units | number |
| Optional leave units | text |
| Leave type ID | number |
| Status comments | text |
| Approved by ID | text |
| Applied by ID | number |
| Cancelled by ID | text |
| Rejected by ID | text |
| Comments | text |
| Rejected at | text |
| Cancelled at | text |
Get a Job Type by IDAction
| Field | Type |
|---|---|
Job Post IDRequired | choice |
| Field | Type |
|---|---|
| Job Post ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Title | text |
| Description | text |
| Status | text |
| Salary | object |
| Min | text |
| Max | text |
| Currency | text |
| Applicant access type | text |
| Remote | boolean |
| Show pursue as career | boolean |
| Closing date | text |
| Experience | text |
| Type | text |
| Branch | object |
| ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
| State | text |
| City | text |
| Country code | text |
| Zip | text |
| Time zone | text |
| Department | object |
| ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
Get an Employee by IDAction
| Field | Type |
|---|---|
Employee IDRequired | choice |
| Include Additional Fields | choice |
| Field | Type |
|---|---|
| Employee ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Work numbers | array |
| Nick name | text |
| Date of birth | text |
| Gender | text |
| Address | object |
| Street | text |
| State | text |
| City | text |
| Country code | text |
| Zip code | text |
| Phone numbers | array |
| Communication address | object |
| Same as residential | boolean |
| Communication street | text |
| Communication state | text |
| Communication city | text |
| Communication country code | text |
| Communication zip code | text |
| Designation | text |
| Joining date | text |
| Branch ID | number |
| Team ID | number |
| Business unit ID | number |
| Sub department ID | text |
| Department ID | text |
| Reporting to ID | text |
| Hr incharge ID | text |
Get Employee FieldsAction
| Field | Type |
|---|---|
| EEmployee Field ID | number |
| Created at | date |
| Updated at | date |
| Employee form ID | number |
| Name | text |
| Label | text |
| Field type | text |
| Position | number |
| Default | boolean |
| Viewable by | text |
| Editable by | text |
| Tab | text |
| Field scopes | array |
Get Hire by IDAction
| Field | Type |
|---|---|
Hire IDRequired | text |
| Field | Type |
|---|---|
| Hire ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Eeo ethnicity | text |
| Eeo job category | text |
| ID card details | text |
| Workstation number | text |
| Work numbers | array |
| Nick name | text |
| Date of birth | text |
| Marital status | text |
| Gender | text |
| Blood group | text |
| Emergency contacts | text |
| Social profiles | text |
| Address | object |
| Street | text |
| City | text |
| State | text |
| Country code | text |
| Zip code | text |
| Phone numbers | text |
| Communication address | object |
| Communication street | text |
| Communication city | text |
| Communication state | text |
| Communication country code | text |
| Communication zip code | text |
| Same as residential | boolean |
| Designation | text |
Get Time Off by IDAction
| Field | Type |
|---|---|
Time Off IDRequired | choice |
| Field | Type |
|---|---|
| Time Off ID | number |
| Created at | date |
| Updated at | date |
| User ID | number |
| Start date | date |
| End date | date |
| Status | text |
| Leave units | number |
| Optional leave units | text |
| Leave type ID | number |
| Status comments | text |
| Approved by ID | text |
| Applied by ID | number |
| Cancelled by ID | text |
| Rejected by ID | text |
| Comments | text |
| Rejected at | text |
| Cancelled at | text |
List Applicant FieldsSearch
| Field | Type |
|---|---|
| Job Post ID | choice |
| Limit | number |
| Field | Type |
|---|---|
| ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Applicant form ID | number |
| Name | text |
| Field type | text |
| Label | text |
| Position | number |
| Default | boolean |
| Group label | text |
| Group position | text |
| Group name | text |
| External field | boolean |
| Recruiter field | boolean |
| Vendor field | boolean |
| Required in vendor form | boolean |
| Viewable by | text |
| Required in external form | boolean |
| Required in recruiter form | boolean |
List BranchesSearch
List Business UnitsSearch
List Candidate Source CategoriesSearch
List Candidate SourcesSearch
List DepartmentsSearch
List EmployeesSearch
| Field | Type |
|---|---|
| Status | choice |
| First Name | text |
| Last Name | text |
| Personal Email | text |
| Official Email | text |
| Employee Type | text |
| Department ID | text |
| Business Unit ID | text |
| Location ID | text |
| Reporting Manager ID | text |
| Updated Since | date |
| Sort By | choice |
| Sort Type | choice |
| Draft | boolean |
| Terminated | boolean |
| Deleted | boolean |
| Limit | number |
| Field | Type |
|---|---|
| Employee ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Work numbers | array |
| Nick name | text |
| Date of birth | text |
| Gender | text |
| Address | object |
| Street | text |
| State | text |
| City | text |
| Country code | text |
| Zip code | text |
| Phone numbers | array |
| Communication address | object |
| Same as residential | boolean |
| Communication street | text |
| Communication state | text |
| Communication city | text |
| Communication country code | text |
| Communication zip code | text |
| Designation | text |
| Joining date | text |
| Branch ID | number |
| Team ID | number |
| Business unit ID | number |
| Sub department ID | text |
| Department ID | text |
| Reporting to ID | text |
| Hr incharge ID | text |
List Job Posting FieldsSearch
List Job PostingsSearch
| Field | Type |
|---|---|
| Status | choice |
| Job Title | text |
| Job Type | text |
| Department ID | number |
| Location ID | number |
| Remote | choice |
| Location City | text |
| Location Country | text |
| Limit | text |
| Field | Type |
|---|---|
| Job Post ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Title | text |
| Description | text |
| Status | text |
| Salary | object |
| Min | text |
| Max | text |
| Currency | text |
| Applicant access type | text |
| Remote | boolean |
| Show pursue as career | boolean |
| Closing date | text |
| Experience | text |
| Type | text |
| Branch | object |
| ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
| State | text |
| City | text |
| Country code | text |
| Zip | text |
| Time zone | text |
| Department | object |
| ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
List LevelsSearch
List Sub-DepartmentsSearch
List TeamsSearch
List Time Off RequestsSearch
| Field | Type |
|---|---|
| Status | choice |
| Employee ID | choice |
| Leave Type ID | choice |
| Location ID | text |
| Start Date | date |
| End Date | date |
| Limit | number |
| Field | Type |
|---|---|
| Time Off ID | number |
| Created at | date |
| Updated at | date |
| User ID | number |
| Start date | date |
| End date | date |
| Status | text |
| Leave units | number |
| Optional leave units | text |
| Leave type ID | number |
| Status comments | text |
| Approved by ID | text |
| Applied by ID | number |
| Cancelled by ID | text |
| Rejected by ID | text |
| Comments | text |
| Rejected at | text |
| Cancelled at | text |
List TimeOff TypesSearch
Create a Candidate SourceAction
Create a Custom Employee FieldAction
| Field | Type |
|---|---|
Field LabelRequired | text |
| Required | boolean |
Section NameRequired | text |
Field TypeRequired | choice |
Create a New HireAction
| Field | Type |
|---|---|
Employee IDRequired | choice |
First NameRequired | text |
Last NameRequired | text |
StatusRequired | choice |
| Official Email | |
Personal EmailRequired | |
| Employee Type | choice |
| Work Numbers | array |
| Date of Birth | date |
| Gender | choice |
| Blood Group | choice |
| Address | object |
| Street | text |
| City | text |
| State | text |
| Country Code | text |
| ZIP Code | text |
| Communication Address | object |
| Communication Street | text |
| Communication City | text |
| Communication State | text |
| Communication Country Code | text |
| Communication ZIP Code | text |
| Same as Residential | boolean |
| Designation | text |
Joining DateRequired | date |
| Branch ID | choice |
| Team ID | choice |
| Business Unit ID | choice |
| Sub Department ID | choice |
| Department ID | choice |
| Field | Type |
|---|---|
| Hire ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Eeo ethnicity | text |
| Eeo job category | text |
| ID card details | text |
| Workstation number | text |
| Work numbers | array |
| Nick name | text |
| Date of birth | text |
| Marital status | text |
| Gender | text |
| Blood group | text |
| Emergency contacts | text |
| Social profiles | text |
| Address | object |
| Street | text |
| City | text |
| State | text |
| Country code | text |
| Zip code | text |
| Phone numbers | text |
| Communication address | object |
| Communication street | text |
| Communication city | text |
| Communication state | text |
| Communication country code | text |
| Communication zip code | text |
| Same as residential | boolean |
| Designation | text |
Create an ApplicantAction
| Field | Type |
|---|---|
Job Post IDRequired | choice |
First NameRequired | text |
| Middle Name | text |
Last NameRequired | text |
EmailRequired | |
| Mobile | text |
| Phone | text |
Owner IDRequired | choice |
Source IDRequired | choice |
Source Category IDRequired | choice |
| Gender | choice |
| Custom Fields | object |
| Candidate ID | text |
| Field | Type |
|---|---|
| ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Status | text |
| Job ID | number |
| Requisition ID | number |
| Custom fields | object |
| Cf custom example | text |
| Stage ID | number |
| Candidate | object |
| ID | number |
| Eeo veteran | text |
| Eeo ethnicity | text |
| Eeo disabled | text |
| Eeo gender | text |
| First name | text |
| Middle name | text |
| Last name | text |
| text | |
| Source ID | number |
Create an EmployeeAction
| Field | Type |
|---|---|
First NameRequired | text |
Last NameRequired | text |
Official EmailRequired | |
| Employee Type | choice |
Role IDsRequired | array |
| Role ID | number |
| Employee ID | text |
| Middle Name | text |
| Personal Email | |
| Work Numbers | array |
| Phone Numbers | array |
| Date of Birth | date |
| Designation | text |
| Joining Date | date |
| Branch ID | number |
| HR Incharge ID | number |
| Reporting To ID | number |
| Business Unit ID | number |
| Sub Department ID | number |
| Shift ID | number |
| Department ID | number |
| Field | Type |
|---|---|
| Employee ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Work numbers | array |
| Nick name | text |
| Date of birth | text |
| Gender | text |
| Address | object |
| Street | text |
| State | text |
| City | text |
| Country code | text |
| Zip code | text |
| Phone numbers | array |
| Communication address | object |
| Same as residential | boolean |
| Communication street | text |
| Communication state | text |
| Communication city | text |
| Communication country code | text |
| Communication zip code | text |
| Designation | text |
| Joining date | text |
| Branch ID | number |
| Team ID | number |
| Business unit ID | number |
| Sub department ID | text |
| Department ID | text |
| Reporting to ID | text |
| Hr incharge ID | text |
Create Time Off RequestAction
| Field | Type |
|---|---|
User IDRequired | choice |
Start DateRequired | date |
End DateRequired | date |
Leave Type IDRequired | choice |
| Status | choice |
| Leave Units | number |
| Optional Leave Units | number |
| Status Comments | text |
| Approved By ID | choice |
| Applied By ID | choice |
| Cancelled By ID | choice |
| Rejected By ID | choice |
| Comments | text |
| Rejected At | date |
| Cancelled At | date |
| Field | Type |
|---|---|
| Time Off ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
| Description | text |
| Applicable for | text |
| Default | boolean |
| Auto approve | boolean |
| Auto approve after | text |
| Auto approve limit | text |
| Marital status | text |
Make an API Calluniversal
Send Employee Portal Invitation EmailAction
| Field | Type |
|---|---|
Employee IDRequired | choice |
Send Invite EmailRequired | boolean |
Update a New HireAction
| Field | Type |
|---|---|
Hire IDRequired | text |
Employee IDRequired | choice |
| First Name | text |
| Last Name | text |
StatusRequired | choice |
| Official Email | |
| Personal Email | |
| Employee Type | choice |
| Work Numbers | array |
| Date of Birth | date |
| Gender | choice |
| Blood Group | choice |
| Address | object |
| Street | text |
| City | text |
| State | text |
| Country Code | text |
| ZIP Code | text |
| Communication Address | object |
| Communication Street | text |
| Communication City | text |
| Communication State | text |
| Communication Country Code | text |
| Communication ZIP Code | text |
| Same as Residential | boolean |
| Designation | text |
| Joining Date | date |
| Branch ID | choice |
| Team ID | choice |
| Business Unit ID | choice |
| Sub Department ID | choice |
Update a Time Off RequestAction
| Field | Type |
|---|---|
| Time off ID | choice |
| Status | choice |
| Approved By ID | choice |
| Comments | text |
| Field | Type |
|---|---|
| Time Off ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Name | text |
| Description | text |
| Applicable for | text |
| Default | boolean |
| Auto approve | boolean |
| Auto approve after | text |
| Auto approve limit | text |
| Marital status | text |
Update a Time Off RequestAction
| Field | Type |
|---|---|
| Tim off ID | choice |
| Status | choice |
| Cancelled By ID | choice |
| Rejected By ID | choice |
| Comments | text |
| Rejected At | date |
| Cancelled At | date |
| Field | Type |
|---|---|
| Time Off ID | number |
| Created at | date |
| Updated at | date |
| User ID | number |
| Start date | date |
| End date | date |
| Status | text |
| Leave units | number |
| Optional leave units | text |
| Leave type ID | number |
| Status comments | text |
| Approved by ID | text |
| Applied by ID | number |
| Cancelled by ID | text |
| Rejected by ID | text |
| Comments | text |
| Rejected at | text |
| Cancelled at | text |
Update an EmployeeAction
| Field | Type |
|---|---|
Employee IDRequired | choice |
| First Name | text |
| Last Name | text |
Official EmailRequired | |
| Employee Type | choice |
| Role IDs | array |
| Role ID | number |
| Employee ID | text |
| Middle Name | text |
| Personal Email | |
| Work Numbers | array |
| Phone Numbers | array |
| Date of Birth | date |
| Designation | text |
| Joining Date | date |
| Branch ID | number |
| HR Incharge ID | number |
| Reporting To ID | number |
| Business Unit ID | number |
| Sub Department ID | number |
| Shift ID | number |
| Field | Type |
|---|---|
| Employee ID | number |
| Created at | date |
| Updated at | date |
| Deleted | boolean |
| Work numbers | array |
| Nick name | text |
| Date of birth | text |
| Gender | text |
| Address | object |
| Street | text |
| State | text |
| City | text |
| Country code | text |
| Zip code | text |
| Phone numbers | array |
| Communication address | object |
| Same as residential | boolean |
| Communication street | text |
| Communication state | text |
| Communication city | text |
| Communication country code | text |
| Communication zip code | text |
| Designation | text |
| Joining date | text |
| Branch ID | number |
| Team ID | number |
| Business unit ID | number |
| Sub department ID | text |
| Department ID | text |
| Reporting to ID | text |
| Hr incharge ID | text |
Templates
Look for FreshTeam templates in the WEXTL template library.
Browse templates →Explore alternative apps
- Base.vn[2]Workplace suite for HR, requests, meetings, time off, and team operations.
- Breathe HRCloud HR software for employee records, leave, onboarding, and people management.
- BrioHRHR management platform for employee data, leave, payroll-ready records, and people operations.
- BuddyPunchEmployee time clock and attendance tracking for hourly teams.
- CalamariHR leave, attendance, and timesheet management for growing teams.
References
- WEXTL® FreshTeam Source Code connector implementation.
- Our users use cases and automations.
- Official API Documentation for FreshTeam.
- WEXTL® visual workflow builder data.
Last updated: Jul 24, 2026 18:11
