For the complete documentation index, see llms.txt
For the complete documentation index, see llms.txt
Troubleshooting HiBob Integration Setup Issues with Zinc
## Permission not found
If Zinc indicates that the permission cannot be found, it may not have the correct permissions in your HiBob account. Double-check that the fields and permissions you've set up match our [set up guide](https://help.zincwork.com/hc/hm54ky7yrc/article/1facbeca-how-to-integrate-zinc-with-hibob-hris-step-by-step-setup-guide) exactly.
This could be due to:
- Permissions are incorrectly configured in HiBob
- Fields are not named exactly as required
Here is what your Permissions and fields should look like.
## Zinc cannot find the field
For Zinc to find the fields, they must match the required setup precisely.
The correct field names are:
| General - required fields | Zinc Status |
| --- | --- |
| Zinc Date of check | |
| Zinc Type of check | |
| Zinc Report Link | |
| Zinc Report | |
| UK Right to Work - required only if completing UK right to work | Zinc RTW Document Expiry |
| ZInc Document Type | |
| Zinc Nationality or Share Code | |
| Optional | Zinc RTW Status |
⚠ **Important:** Field names must match exactly as specified. For example, "status" or "Status Zinc" will not work—the correct field is **Zinc Status**.
## Incorrect field type
Each required field must be set up with the correct type:
| **Zinc Status** | Text |
| --- | --- |
| Zinc Date of check | Date |
| Zinc Type of check | Text |
| Zinc Report Link | Text |
| Zinc Report | Document |
| Zinc RTW Document Expiry | Text |
| ZInc Document Type | Text |
| Zinc Nationality or Share Code | Text |
| Zinc RTW Status | Text |
## Fields exist but are in different categories
For the integration to work, all fields must be in the same custom category within HiBob.
## Right to Work not showing for a candidate
If Right to Work information isn't appearing, reconfigure your HiBob integration and make sure you've toggled on **Right to Work**.
## How do I know if my HiBob setup has been done
Once you have successfully completed your integration, when you select HiBob in your company settings you will see the **Add API key** button change to **Update API key**.
❌ Not integrated
✅ Integrated
## Common issues
### A report or document isn't syncing
Check the file size first: download a copy of the report and see if it's larger than **2MB**. This is the most likely cause — the report will need to be uploaded manually, as this limit is controlled by HiBob, not Zinc.
If the file isn't over 2MB, an email mismatch is the next most likely cause — see below.
### Candidate is not appearing in HiBob
If the HiBob integration is set up but a candidate isn't showing, check the following:
- **Email mismatch**: the most likely cause. Verify the candidate's email address in HiBob and make sure it matches the email address in Zinc.
- **Profile status**: the candidate's HiBob profile status must be set to **Employed** or **Hired** for syncing to occur.
### Candidate's documents are missing
If the candidate appears in HiBob but documents are missing, this is likely a permissions issue related to uploading and deleting documents in the employee's document folder.
- Solution: Review Step 7 of the setup guide to confirm you have the correct permissions
### Candidate's documents are missing in HiBob
Ensure that all fields are set up within the same custom category to ensure data syncs properly.
## ⚠ Important
If you make any changes to your Setup, you will need to generate a new token and ID and input this into the integration on Zinc under HiBob repeating Step 8 on the set up guide. Please use the video attached as guidance on how to refresh your token and ID.
## Good to Know
**Do I need to set up a webhook for the HRIS side of the integration?**
No — webhook setup is only needed for the ATS side of the integration, not HRIS.
**Will adding a new joiner in HiBob automatically trigger a Zinc check?**
No — HiBob doesn't support automatically triggering a check from HiBob into Zinc. ATS and HRIS are separate integrations.
**Will checks for a new hire sync if they haven't been moved into HiBob's "People" section yet?**
They'll queue, but won't complete syncing until the person is moved into "People."
**Does deleting data in Zinc also remove it from HiBob?**
No — once synced to HiBob it becomes a separate record, and the business manages its own deletion from that point.