Changelog

We're excited to announce the launch of our new Employee Management flow, a centralized interface for managing W-2 employees throughout their lifecycle.

Added completion timestamps to the GET /v1/company/onboarding_status endpoint to help you track when your companies complete each onboarding step. This enables you to integrate with marketing automation platforms (e.g., Mailchimp, Iterable) and send targeted onboarding nudges when companies get stuck.

Added the GET /v1/webhooks/health_check endpoint to monitor the status of your webhook system. Poll this endpoint to check webhook delivery health within the last 10 minutes.

Added three new categories to the Embedded Partner Notification system:state_tax_setup_request_required_authorization, state_tax_setup_request_authorization, and state_tax_setup_multi_step_request_authorization.

Added GET /v1/company_benefits/{company_benefit_id}/contribution_exclusions and PUT /v1/company_benefits/{company_benefit_id}/contribution_exclusions for 401(k) and Roth 401(k) benefit types.

Added additional rate limit data to API response headers. The following headers are now available to use when handling rate limiting programmatically:

Added company.unsuspended, contractor.reactivated, and ContractorPaymentGroup webhooks: contractor_payment_group.created and contractor_payment_group.cancelled.

To further improve performance of our payroll API endpoints, v2025-06-15 introduces the changes outlined below.

Updated GET /v1/companies/{company_id}/employees to let you fetch a company's employees by their UUIDs. Added functionality to PUT /v1/companies/{company_id}/payrolls/{payroll_id}/prepare to accept a list of employee UUIDs such that only those employee compensations will be prepared for update.

We've added the payroll UUID as a resource in the bank_error.employee_ach_credit_failure notification so partners can easily reconcile the relevant payroll whenever they receive this notification.