--- title: Namely API Integration on Truto slug: namely category: HRIS canonical: "https://truto.one/integrations/detail/namely/" --- # Namely API Integration on Truto **Category:** HRIS **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Companies** — Companies represent the companies in HRIS - **Employees** — Represents an employee in HRIS - **Groups** — Groups represent the groups for an Employee ## How it works 1. **Link your customer's Namely account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Namely.** The Proxy API is a 1-to-1 mapping of the Namely API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync employee rosters to power identity and access management** — IT security and IAM platforms can pull the full employee directory from Namely — including active/inactive status and department membership — to automate software provisioning and deprovisioning without manual CSV imports. - **Automate org hierarchy for approval routing** — Spend management, procurement, and workflow tools can read Namely's 'Reports To' manager field and department groups to build dynamic approval chains that stay current as employees change roles. - **Trigger onboarding workflows from new hire events** — LMS, IT asset, and onboarding platforms can detect newly created employee profiles in Namely and kick off location- or department-specific workflows — like enrolling a new hire in compliance training or shipping hardware. - **Keep employee data fresh across your product** — Any B2B SaaS app that needs accurate people data — names, emails, job titles, departments — can treat Namely as the source of truth and sync changes continuously through Truto's Unified HRIS API. - **Automate offboarding when employees are terminated** — Security, finance, and collaboration tools can react to terminated employee statuses in Namely to revoke access, reclaim licenses, and freeze corporate cards without waiting for a manual HR ticket. ## What you can build - **Real-time employee directory sync** — Continuously import and update employee profiles — including name, email, title, start date, and status — from Namely into your product using the Unified Employees model. - **Dynamic manager-based approval chains** — Map Namely's 'Reports To' hierarchy to automatically route approvals, reviews, or escalations to the correct manager inside your app. - **Department and location-aware automation rules** — Read Namely's Groups data to trigger different workflows based on an employee's department, division, or office location — such as assigning region-specific training or budget policies. - **Automated new hire detection and onboarding kickoff** — Poll or listen for new employee profiles in Namely and automatically enroll them in your product's onboarding flow with the right permissions and configuration. - **Offboarding and access revocation pipeline** — Detect inactive or terminated employee statuses and trigger downstream cleanup — revoking licenses, archiving accounts, or notifying admins — with zero manual intervention. - **Company-level configuration sync** — Pull top-level organizational details from Namely's company data to auto-configure tenants, enforce locale-specific settings, or validate address formats in your product. ## FAQs ### What Unified API models does Truto support for Namely? Truto maps Namely to the Unified HRIS API, which includes Companies, Employees, and Groups. These cover Namely's Profiles, Groups/Teams, and system-level company information. Additional tools or custom endpoints can be built on request. ### How does authentication work for Namely integrations? Truto handles the OAuth flow for Namely so your end users can securely connect their Namely accounts without you managing tokens, refresh cycles, or credential storage. ### Are there rate limits I need to worry about? Yes. Namely enforces a strict rate limit of 100 requests per minute on profile-related endpoints and returns an HTTP 406 error when exceeded. Truto manages pagination and request orchestration to help you stay within these limits. ### Does Namely support webhooks for real-time data? Namely offers native webhooks for events like profile.created, profile.updated, profile.terminated, and profile.rehired. These can be configured in the Namely admin UI to reduce reliance on polling. ### What employee data is available through the integration? The Unified Employees model maps to Namely's Profiles endpoint, which includes personal details, work email, job title, start date, active/inactive status, and the manager (Reports To) relationship. ### What if I need data or actions beyond the Unified HRIS API? Truto builds additional tools and proxy endpoints on request. If you need access to Namely-specific features like the Home Feed or custom fields, reach out and Truto can extend coverage for your use case.