GETRead employees
curl -H "Authorization: Bearer ch_live_..." \
"https://cozyhr.com/api/public/v1/employees?status=ACTIVE&limit=50"Sync employee codes, names, emails, departments and locations into internal systems.
Menu
Products
HR SoftwareEmployee master and org setup.Employee Self ServicePortal for employees and managers.Mobile AppMobile-ready HR actions.Employee EngagementAnnouncements and workforce touchpoints.Payroll SoftwarePreview, process and govern payroll.Leave ManagementPolicies, balances and approvals.Attendance ManagementDevices, shifts and monthly locks.Expense ManagementClaims, approvals and settlement.Recruitment SoftwareCandidate handoff to onboarding.Performance ManagementGoals, reviews and feedback.MarketplaceDevices, APIs and partner systems.
Docs
Developer DocsQuickstart for API keys, scopes and endpoints.REST API ReferenceEmployees, attendance punches and JSON payloads.AuthenticationAPI keys, OAuth, scopes and rate limits.Employees APIRead tenant employee directory records.Attendance APIIngest biometric and middleware punches.WebhooksDelivery logs, retries and endpoint setup.REST API HR AutomationCase study for internal HR automation.Biometric Attendance SyncBlog guide for punch API rollouts.Payroll API GuidePlanning payroll-adjacent integrations.
Resources
What is HRMS?Meaning, modules and HRMS buying context.What is Payroll?Payroll process, deductions and controls.Statutory CompliancePF, ESI, PT, TDS and compliance basics.Leave Management GuidePolicies, balances and approval paths.Attendance Management GuidePunches, shifts, rosters and monthly locks.Performance Management GuideGoals, reviews and manager feedback.BlogHRMS, payroll and compliance articles.GuidesDeep implementation-ready explainers.TemplatesPolicies, forms and payroll checklists.EbooksLong-form HRMS planning resources.Holiday Lists 2026Calendar planning for teams and locations.Gender Inclusivity ReportInclusive HR operations and reporting.WebinarsLive product and HR operations sessions.PodcastsConversations with HR and payroll leaders.AcademyRole-wise CozyHR learning paths.CommunityPeer support for HR operators.Case StudiesCustomer rollout and payroll outcomes.Book a DemoSee CozyHR workflows with your use case.API Case StudyREST API automation proof story.Attendance API BlogBiometric middleware and punch API guide.
Compliance
PF ActConfigure this CozyHR workflow with clean records and guided admin controls.ESI ActConfigure this CozyHR workflow with clean records and guided admin controls.Factories ActConfigure this CozyHR workflow with clean records and guided admin controls.Maternity Benefit ActConfigure this CozyHR workflow with clean records and guided admin controls.Payment of Gratuity ActConfigure this CozyHR workflow with clean records and guided admin controls.Apprentices ActConfigure this CozyHR workflow with clean records and guided admin controls.Indian StatesConfigure this CozyHR workflow with clean records and guided admin controls.IndustriesConfigure this CozyHR workflow with clean records and guided admin controls.Payroll SoftwareConfigure this CozyHR workflow with clean records and guided admin controls.
Company
AboutConfigure this CozyHR workflow with clean records and guided admin controls.CustomersConfigure this CozyHR workflow with clean records and guided admin controls.CareersConfigure this CozyHR workflow with clean records and guided admin controls.Media KitConfigure this CozyHR workflow with clean records and guided admin controls.PartnersConfigure this CozyHR workflow with clean records and guided admin controls.Payroll Service ProvidersConfigure this CozyHR workflow with clean records and guided admin controls.ContactConfigure this CozyHR workflow with clean records and guided admin controls.BengaluruConfigure this CozyHR workflow with clean records and guided admin controls.ChennaiConfigure this CozyHR workflow with clean records and guided admin controls.DelhiConfigure this CozyHR workflow with clean records and guided admin controls.HyderabadConfigure this CozyHR workflow with clean records and guided admin controls.MumbaiConfigure this CozyHR workflow with clean records and guided admin controls.PuneConfigure this CozyHR workflow with clean records and guided admin controls.DubaiConfigure this CozyHR workflow with clean records and guided admin controls.
Support
Online SupportConfigure this CozyHR workflow with clean records and guided admin controls.Payroll System SupportConfigure this CozyHR workflow with clean records and guided admin controls.Mobile App SupportConfigure this CozyHR workflow with clean records and guided admin controls.Leave SupportConfigure this CozyHR workflow with clean records and guided admin controls.ESS SupportConfigure this CozyHR workflow with clean records and guided admin controls.Attendance SupportConfigure this CozyHR workflow with clean records and guided admin controls.Implementation ServicesConfigure this CozyHR workflow with clean records and guided admin controls.
Developer docsREST API
CozyHR API Authentication
How to authenticate CozyHR REST API calls using API keys, OAuth client credentials, scopes and rate limits.
Last updated: · CozyHR editorial team
Developer documentation
REST
API style
Bearer
auth model
JSON
payloads
API key creation
OAuth client credentials
Scoped access control
API quickstart
Start with a scoped Bearer token
CozyHR public APIs are tenant-scoped. Create a key in the developer console, pass it as a Bearer token and keep secrets out of browser code.
POSTIngest attendance punches
curl -H "Authorization: Bearer ch_live_..." \
-H "Content-Type: application/json" \
-d '{"employeeCode":"CH-001","punchType":"IN"}' \
"https://cozyhr.com/api/public/v1/attendance/punches"Send biometric or middleware IN/OUT punches while keeping raw logs available for recalculation.
POSTIssue OAuth token
curl -H "Authorization: Bearer ch_live_..." \
-H "Content-Type: application/json" \
-d '{"employeeCode":"CH-001","punchType":"IN"}' \
"https://cozyhr.com/api/oauth/token"Use client credentials when a backend integration needs scoped, revocable API access.
SEO answer block
What this CozyHR page covers
CozyHR API Authentication is a CozyHR.com resource for teams evaluating developer documentation in a modern HRMS. How to authenticate CozyHR REST API calls using API keys, OAuth client credentials, scopes and rate limits. It covers api key creation, oauth client credentials, scoped access control and explains how CozyHR connects api keys and oauth client credentials with employee records, attendance, payroll, compliance workflows and Super Admin controls. The page is written for HR admins, payroll managers, founders and operations teams who need practical software context rather than a thin brochure page.
API key creation
OAuth client credentials
Scoped access control
Developer docs
API keys
Tenant admins create hash-backed API keys with scopes, expiry and per-minute limits. Secrets are shown once for secure storage.
One-time reveal
Scope selection
Rotation workflow
Developer docs
OAuth client credentials
Use OAuth apps when backend systems need client ID and client secret based token issuance with revocation and audit history.
Client ID
Client secret
Access token
Implementation workflow
How teams implement this in CozyHR
A good HRMS page should explain the operational path, not only list features. The steps below show how this workflow moves from evaluation to daily use inside CozyHR.
1
Map the current process
Document how API Authentication works today across HR, finance, managers and employees.
2
Configure CozyHR
Create the required company setup, employee fields, policies, approval paths and role access in CozyHR.
3
Import and validate data
Load employee records, device mappings, salary values, statutory IDs, documents and historical context.
4
Operate with audit trails
Run day-to-day workflows with database-backed records, review states, reports and Super Admin visibility.
Frequently asked questions
Questions HR teams ask before buying
These answers are written as plain, crawlable content for buyers and AI search systems. They keep the page useful even before someone opens the product.
What is CozyHR API Authentication?
CozyHR API Authentication is a CozyHR.com resource for teams evaluating developer documentation in a modern HRMS. How to authenticate CozyHR REST API calls using API keys, OAuth client credentials, scopes and rate limits. It covers api key creation, oauth client credentials, scoped access control and explains how CozyHR connects api keys and oauth client credentials with employee records, attendance, payroll, compliance workflows and Super Admin controls. The page is written for HR admins, payroll managers, founders and operations teams who need practical software context rather than a thin brochure page.
Who should use CozyHR API Authentication?
CozyHR API Authentication is useful for HR admins, payroll managers, operations leaders and tenant owners who want structured software for api key creation.
How does CozyHR support this workflow?
CozyHR connects this page's workflow to employee master data, organization setup, attendance, payroll, approvals, reports and Super Admin configuration so the process stays governed end to end.
Can this be configured for Indian payroll and compliance?
Yes. CozyHR is designed with India-first HR and payroll context including PF, ESI, professional tax, TDS, employee documents, attendance devices, shift policies and payroll review workflows.
CozyHR next step
Open developer docs Build on the CozyHR REST API.
Create API keys in the developer console, test employee and attendance endpoints, then attach webhook delivery logs for production monitoring.