Create, update, and cancel member payroll deductions via the Justworks Partner API
domain: hr-payroll · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Ensure your OAuth token carries the deductions:write scope, which inherits deductions:read
POST an array of deduction items to the create-deductions endpoint, each with member_id, amount_type, amount, currency, deduction_type_code, frequency, and start_date/end_date
Include a client-generated operation_id per item so you can correlate the per-item success/error results returned in the response
PATCH the update-deductions endpoint with an array of deduction_id-keyed items to change amount, dates, or description on existing deductions
POST an array of deduction_ids to the cancel-deductions endpoint to stop future deductions
Known gotchas
Currency values are zero-decimal in the API - a $45.00 fixed amount is represented as 4500, and percentage amounts use 4 significant digits (3.7% as 37000)
Each write call returns a per-item success/error result, not an all-or-nothing outcome - check every item's success field rather than assuming the whole batch succeeded
deduction_type_code is a free-form string in the schema - confirm the valid set of codes with Justworks rather than assuming a fixed enum
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?