Success

Bad request — invalid request body, validation error, or deduction rejected by US Payroll.

Unauthorized — the OAuth 2.0 access token is missing, invalid, or expired.

Forbidden — the authenticated caller does not have permission to perform this operation on the requested company, employer, or employee.

Not found — the requested employer, employee, pay cycle, or deduction could not be found, or the authenticated caller is not authorized to see it.

Too many requests — rate limit exceeded. Read the limit per operation (most reads are 5/minute, mutations 200/minute) and retry after the indicated delay.

Internal server error — an unexpected error occurred. Retry with exponential backoff; if the error persists, contact HiBob support with the requestId from the response body.