# Namely — HRIS API: overview

> Canonical URL: https://developers.apideck.com/apis/hris/namely/overview

Namely is the only HR, payroll, benefits, and talent management platform your employees will love. It’s more than HR software: It’s the compliance and benefits consulting you need.
- Status: live
- Authentication: oauth2

- **account type required:** Paid Namely account with API access enabled.
- **partnership note:** Namely's partner page takes integration enquiries at hello@namely.com.
- **sandbox available:** false
- **difficulty reason:** Partner Enquiry or Admin Access Needed for OAuth Credentials
- **partnership required:** false
- **consumer access level:** A Namely administrator, or a user an administrator has granted API access.
- **responsibility matrix:**   - **area:** Enable the connector
  - **customer:** ✓ In the Apideck Dashboard
  - **customer:** ✓
  - **area:** Obtain the OAuth client ID and secret from Namely and enter them in the Apideck Dashboard
  - **consumer:** ✓ (administrator)
  - **customer:** Implement Vault
  - **area:** Authorise the connection and enter the company subdomain in Vault
  - **apideck:** ✓
  - **area:** Store credentials, keep the connection authorised and poll for webhook events
- **apideck credentials available:** false
- **beta:** false
- **important to know:** You connect Namely with your own OAuth client ID and secret. Sources disagree on whether a tenant admin can create these directly or they come through Namely's partner route, so confirm the route with Namely before you plan around it.
- **authentication note:** Authorization Code flow.
- **sandbox note:** Test against a live Namely account; Namely documents no public route to request a sandbox tenant.
- **webhooks:** Virtual webhooks - employee created, updated and terminated events.
- **external guides:**   - **url:** https://developers.namely.com/docs/namely-api/ZG9jOjgwMzMxNjE-introduction
  - **source:** Namely
  - **title:** Namely API documentation
- **difficulty:** moderate
- **partnership url:** https://namely.com/partners/
- **apideck credentials note:** Apideck holds no Namely OAuth app.
- **environment notes:**   - **environment:** Production
  - **description:** Single environment: each connection calls the consumer's own tenant at https://{company}.namely.com/api/v1, set by the required company subdomain setting. Tests run on real employee data.
- **rate limits:** 100 requests per minute on GET /profiles.

## Supported resources

- **status:** live
- **custom field support:** true
- **id:** employees
- **name:** Employees
- **downstream name:** Profiles
- **downstream id:** profiles
- **downstream name:** Companies
- **downstream id:** companies
- **id:** companies
- **status:** live
- **name:** Companies
- **custom field support:** false

An omitted operation list does not establish operation support. Verify the selected operation in the coverage matrix.

[API reference](https://developers.apideck.com/apis/hris/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/hris/coverage)