Added completed_at field to company onboarding status endpoint
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 webhook healthcheck endpoint
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 categories to Partner Notification system
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 endpoints to get and update contribution exclusions for company benefits
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 rate limit headers
Added additional rate limit data to API response headers. The following headers are now available to use when handling rate limiting programmatically:
Added webhooks
Added company.unsuspended
, contractor.reactivated
, and ContractorPaymentGroup webhooks: contractor_payment_group.created
and contractor_payment_group.cancelled
.
v2025-06-15
To further improve performance of our payroll API endpoints, v2025-06-15
introduces the changes outlined below.
Added functionality to fetch employees of a company by UUIDs, and prepare a payroll by employee UUIDs
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.
Improved notification to expose payroll UUID
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.
Added Get All Notifications endpoint
We've added an endpoint /v1/companies/{company_uuid}/notifications to fetch all notifications for a given company.