# API, webhooks, and AI tools

**Category:** [Employee Directory](https://help.totalctrl.app/hc/totalctrl/totalctrl-help-center/en-US/categories/employee-directory)
**Updated:** 2026-08-19

The directory exposes its people data to the rest of your stack.
## REST API

- `GET /api/v1/directory/employees` — list/search people.
- `GET /api/v1/directory/employees/{id}` — one person's profile.
- `GET /api/v1/directory/departments` — departments.
- `GET /api/v1/directory/org-chart` — the nested reporting tree.

## Webhooks

Subscribe to `employeedirectory.employee.created`, `.updated`, `.deactivated`, `department.updated`, and `hris.synced` to react to people changes in real time.
## Orchestration

Build no-code workflows from the *Employee Added*, *Employee Updated*, and *Employee Deactivated* triggers — e.g. kick off onboarding when someone joins, or offboarding when they're deactivated.
## AI agent

The AI assistant can answer questions like “who runs Marketing?” or “find people in Engineering” using built-in directory tools.

---

## Related Articles

- [Employee Directory overview](https://help.totalctrl.app/en-US/articles/employee-directory-overview)
- [Provision users with SCIM (Okta, Microsoft Entra)](https://help.totalctrl.app/en-US/articles/scim-provisioning)
- [Profiles and self-service editing](https://help.totalctrl.app/en-US/articles/profiles-and-self-service)
- [The org chart](https://help.totalctrl.app/en-US/articles/directory-org-chart)
- [Sync your HRIS (BambooHR)](https://help.totalctrl.app/en-US/articles/hris-sync)

---
[← Back to TotalCtrl Help Center](https://help.totalctrl.app/en-US/)