workhuman-reference-architecture

Workhuman Reference Architecture

Overview

Guidance for reference architecture 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

• Workhuman Platform
• Workhuman Integrations

Next Steps

See related Workhuman skills for more patterns.