Changelog

What's new in the Happily.ai API. Dates are in YYYY-MM-DD.

2026-06-04 — New developer documentation

Relaunched the developer site with a complete, interactive API Reference powered by an OpenAPI specification, plus guides and recipes.
Documented all current endpoints across Recognition, Members, Surveys, Performance, and Town Hall.

Note

Endpoint paths in this reference are being finalized against the deployed gateway. See Migrating from the old docs for the mapping from the previous site.

Recent API additions

These capabilities were added to the API ahead of the documentation relaunch.

Member import

POST /api/v1/members bulk-creates and updates members (up to 1,000 per request) with validation, duplicate handling (skip_duplicates, update_if_exists), and auto team creation.
Returns an import_id, a summary, per-member details, and a rate_limit object.
See Sync members from your HRIS.

Rate limiting

Member import is limited to 10 requests per minute, per API key, with a RATE_LIMIT_EXCEEDED error and reset_at timestamp when exceeded.
See Rate limits.

Performance

POST /api/v1/performance-boosts submits manager review boosts (single or batched up to 200), with goal and culture ratings and per-item results.
POST /api/v1/performance-preset saves reusable review templates assigned to teams or members.
GET /1/performance_feedback reads feedback between a reviewer and an employee.
See Run a review cycle.

Member profiles

GET /api/v1/users/{email}/profile returns impact rating, engagement health score and status, and optional personal context.

Town Hall

POST /townhall/content triggers Town Hall feed generation for your company.

Performance & reliability

Added an internal caching layer to speed up directory lookups during member import.