Skip to main content
Use the reference field to link Ziik users to records in your own system (e.g. employee ID, HR system key). This enables two-way sync:
  • Your system → Ziik: When creating or updating users via the API, set reference to your external identifier. You can later look up that user in Ziik with GET /users/reference/{reference}.
  • Ziik → your system: When listing or fetching users from Ziik, each user’s reference is returned. Use it to match and update the corresponding record in your system.
Keep reference unique and stable so you can reliably resolve users in both directions and avoid duplicates.