For the complete documentation index, see llms.txt
For the complete documentation index, see llms.txt
Zinc
Help center
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
### Candidate is not appearing in HiBob
If the HiBob integration is set up but a candidate isn't showing, the most likely cause is an incorrect email address. Verify the candidate's email address in HiBob and make sure it matches the email address in Zinc.
### 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.
