Integrate with the Human Interest GraphQL API to sync employee census data and automate 401(k) plan onboarding and contribution processing from a payroll/HRIS platform.
domain: docs.humaninterest.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Read the Human Interest Developers Introduction to confirm your use case (census sync, plan onboarding, contribution data) is supported by the GraphQL API.
Set up API credentials and complete the authorization steps in the Authentication guide before making any calls.
Follow the Quickstart guide to make your first GraphQL call against the Human Interest API and confirm connectivity/credentials work.
Use the "Onboard a 401(k) plan" end-to-end guide to create and prepare a new employer plan for launch via the API.
Send/sync employee census (roster) data through the GraphQL schema so Human Interest can process 401(k) contributions and other plan obligations each pay cycle.
If employees should sign into Human Interest using your platform's identity rather than separate credentials, implement the SSO login integration via OpenID Connect described in the SSO docs.
Known gotchas
This is a GraphQL API (single endpoint, query/mutation payloads), not a REST resource API — client code built for typical REST-style payroll/401(k) integrations needs a different request pattern.
Guideline, one of the most common 401(k) providers, was confirmed to have no public API for payroll integration — per Gusto's own embedded-payroll docs, Guideline integrations run only through a prebuilt UI Flow, so it cannot be used for a direct programmatic route.
Vestwell markets itself as offering 'API-driven' payroll integrations but does not publish a public developer/API reference portal; its documented integration types (one-way, two-way/360°, or fully payroll-provider-managed) are described only in help-center/marketing pages, not a verifiable API spec — treat such vendor claims cautiously until a real public reference is found.
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?