Workhuman Common Errors

---
name: workhuman-common-errors
description: "'Workhuman common errors for employee recognition and rewards API. Use when integrating Workhuman Social Recognition, or building recognition workflows with HRIS systems. Trigger: \"workhuman common errors\". '"
allowed-tools: "Read, Write, Edit, Bash(npm:*), Grep"
category: backend-and-data
source_repo: jeremylongshore/claude-code-plugins-plus-skills
source_path: "plugins/saas-packs/workhuman-pack/skills/workhuman-common-errors/SKILL.md"
source_url: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/HEAD/plugins/saas-packs/workhuman-pack/skills/workhuman-common-errors/SKILL.md
---

# Workhuman Common Errors

## Overview

Guidance for common errors 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](https://www.workhuman.com/)
- [Workhuman Integrations](https://www.workhuman.com/capabilities/integrations/)

## Next Steps

See related Workhuman skills for more patterns.

---

**Source:** [`jeremylongshore/claude-code-plugins-plus-skills`](https://github.com/jeremylongshore/claude-code-plugins-plus-skills) → `plugins/saas-packs/workhuman-pack/skills/workhuman-common-errors/SKILL.md`