Register assessment packages

post

https://api.hibob.com/v1/hiring/assessments/packages

Replace the partner package catalog for the installing company.

Registers or replaces the partner's package catalog for the installing
company. The call is idempotent — safe to retry to refresh names or
descriptions.

Catalog replace semantics:

id and name are required and non-blank; description is optional.
Duplicate package IDs in the same request return 400.
Packages omitted from the POST are soft-archived and cannot be selected for new assessments.
An empty packages array archives all packages for that company/app.
In-flight assessments keep their stored packageId; GET and PATCH on existing assessments remain allowed.
Validation is all-or-nothing — no partial accept.

400 is returned when package id/name are blank

or whitespace-only, or when the request contains duplicate package IDs.

There is no hard maximum package count in v1.

OAuth scope: hiring.integrations:write

Rate limit: default partner API / API gateway limits. See
Rate limiting.

Responses

201

Success

400Bad request — the request body failed validation. See the operation description for the fields validated on that endpoint.

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

403Forbidden — the authenticated partner app does not have the hiring.integrations:write scope.

429Too many requests — rate limit exceeded. Retry after the delay indicated by the platform partner API / API gateway defaults.

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