Editor's Note
workhuman-webhooks-events
Workhuman webhooks events for employee recognition and rewards API.
Install
npx skills add https://github.com/flight505/skill-forge --skill workhuman-webhooks-eventsSKILL.md
Workhuman Webhooks Events
Overview
Guidance for webhooks events with Workhuman Social Recognition and rewards API.
Instructions
Key Workhuman API Concepts
- Auth: OAuth 2.0 client credentials flow
- Recognition: Peer-to-peer and manager nominations with points
- Awards: Configurable levels (bronze, silver, gold, platinum)
- Values: Company values attached to recognitions
- HRIS Sync: Bidirectional sync with Workday, SAP SuccessFactors
- Integrations: Microsoft Teams, Slack, Outlook native plugins
Core API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/v1/recognitions | GET | List recognitions |
/api/v1/recognitions | POST | Create nomination |
/api/v1/recognitions/:id | GET | Get recognition status |
/api/v1/users | GET | List employees |
/api/v1/rewards/catalog | GET | Browse reward catalog |
/api/v1/rewards/redeem | POST | Redeem points for reward |
Error Handling
| Error | Cause | Solution |
|---|---|---|
401 Unauthorized | Token expired | Re-authenticate |
403 Forbidden | Insufficient permissions | Check role/permissions |
422 Validation | Missing fields | Check required fields |
404 Not Found | Invalid ID | Verify resource exists |
Resources
Next Steps
See related Workhuman skills for more patterns.