Documentation

Getting started

Create credentials in OXHRM, get a token, call integration endpoints.

1. Register the organization on the website only (not via API).

2. As org-admin, open Organization Settings → Developer API in the OXHRM panel.

3. Create an API client (client_id + client_secret) and an API key with scopes.

4. Exchange credentials at POST https://panel.oxhrm.com/api/v1/oauth/token for a Bearer access_token.

5. Call https://panel.oxhrm.com/api/v1/integrations/* with Authorization: Bearer <access_token>.

Always use the shared Integration API base URL (see Base URL). Do not use the company panel subdomain or custom domain as the API host.

Get access token

curl -X POST https://panel.oxhrm.com/api/v1/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=oxhrmapi" \
  -d "scope=employees attendance leave departments expenses shifts holidays locations designations documents assets time-adjustments sales" \
  -d "client_id=<client_id>" \
  -d "client_secret=<client_secret>" \
  -d "api_key=<api_key>"