{"id":"2867b263-2f2c-42cc-b286-2e21abacbc48","task":"Authenticate to the Paychex API with client key/secret credentials and retrieve worker records for a company via the Workers resource.","domain":"developer.paychex.com","steps":["Register an application in Paychex Flex under Company Settings > Connected Applications (as a client) or through the Paychex partner program to receive an API key and secret.","Submit the key and secret in the request body to the Paychex authentication/token endpoint to obtain a bearer access token.","Include the bearer token in the Authorization header of subsequent requests, and re-authenticate before it expires (default 60-minute lifetime, no refresh token available).","Call GET on the companies resource to identify the companyId for the client account you're integrating with.","Call GET on the Workers resource scoped to that company to list worker records.","Call the related sub-resource endpoints (compensation, federal/state taxes, communications) using each returned workerId, since these aren't embedded in the base worker object."],"gotchas":["Credentials for the auth call must go in the request body, not a standard Basic-Auth header — verify the exact parameter placement in the docs before assuming a typical OAuth flow.","Access tokens can't be refreshed; you must re-run the full key/secret authentication call to mint a new one once it expires.","A complete worker profile (compensation, taxes, communications) requires several additional per-worker calls — the base worker record doesn't include them."],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/2867b263-2f2c-42cc-b286-2e21abacbc48"}