Happily.ai API guides
Bring recognition, engagement surveys, performance feedback, and people analytics into your own products and workflows. These guides walk you from your first call to production integrations. For the full endpoint catalog, see the API Reference.
Quickstart
Make your first authenticated call in under five minutes.
Authentication
How API keys, stages, and the x-api-key header work.
Pagination
Page through large result sets with page and limit.
Rate limits
Stay within 10 requests/minute and handle 429s gracefully.
Errors & status codes
Every error code, what it means, and how to fix it.
Migrating from the old docs
What changed since the previous developer site.
Recipes
Task-focused walkthroughs with copy-paste code in cURL, Node.js, and Python.
Sync members from your HRIS
Bulk import and keep your directory up to date.
Build a recognition bot
Send coins from Slack, Teams, or your own app.
Run a review cycle
Submit performance boosts and manage presets.
Pull survey analytics
Export questions and responses to your warehouse.
How the API is organized
The API groups endpoints into five areas:
| Area | What it does |
|---|---|
| Recognition | Send coins to people, teams, and cohorts. Read recognition a member received. |
| Members | Sync your directory, list members, read engagement profiles. |
| Surveys | Read survey questions and the responses members submit. |
| Performance | Submit review boosts, read feedback, manage review presets. |
| Town Hall | Generate Town Hall feed content. |
Every request is authenticated with your x-api-key and scoped to your company. Ready? Start with the Quickstart.