Skip to main content
Access: Hub plan. Only administrators and billing admins of the organization can set up the connection.
Hirify integrates with Nicoka through a dedicated API user. The integration imports your jobs, candidates, applications, and the interviews in your Nicoka calendar. It sends the meeting assistant to those interviews and adds your evaluation and the interview notes to the candidate’s file.

​
Connect Nicoka

You need administrator access to Nicoka to create the API user.
1

Create an API user in Nicoka

In Nicoka, open Paramétrage, Administration, Utilisateurs, Utilisateur API and create a dedicated API user. Give it the access listed below.
2

Generate an access token

On that user, generate an access token with Générer un jeton d’accès and copy it.
3

Enter your workspace and your token

In Hirify, in Settings, Integrations, ATS section, click Connect next to Nicoka, then I have my credentials. Enter your subdomain in Nicoka subdomain or address, for example myagency for myagency.nicoka.com. For a trial account, enter the full address of the workspace. Paste the token into API access token and click Connect.
If the API user doesn’t have all the required access, the wizard shows Insufficient permissions and lists what’s missing. Fix the user in Nicoka and try again. The first import is described in Connect your ATS.

​
Set up the webhooks

Without webhooks, Nicoka syncs periodically. Webhooks make it real time. You set them up once, in two steps.
1

Create the webhooks

On the connected Nicoka card, the Webhook setup in Nicoka block is marked To set up. The Open the WebHooks page button leads to Nicoka, under Paramétrage, webHooks. Create one webhook per row of the table shown in the block, with the row’s URL and the header name and value shown. Leave SSL certificate verification on.
2

Create the trigger events

A webhook alone sends nothing. The Open the Events page button leads to the page where you create one event per webhook. Pick the change on create and update, delivery in 15 minutes, and leave the rules and targets at their defaults.
The badge switches to Setup detected as soon as a first signed call arrives.

​
Permissions

The token is encrypted and only used for your organization. You can revoke it from Nicoka.
Hirify checks this access for the API user when you connect:

​
What the integration does

  • Import: jobs, candidates, applications with their stage history, and interviews in your Nicoka calendar.
  • Sync: real time with the webhooks, periodic without them.
  • Assistant on scheduled interviews: while this setting is on, an interview in your Nicoka calendar with a Meet or Teams link gets the meeting assistant. See Interviews from your ATS.
  • Sharing the analysis: an evaluation in the candidate’s file, with the interview notes as a comment. Nicoka doesn’t take a verdict. See Share the analysis.
  • Automations: filling in custom fields and automatic publishing of the interview notes. Summary tags aren’t offered. See ATS automations.
  • Talent pool: imported candidates feed Assistant, Sourcing, Analytics, and Data reliability.

​
Troubleshooting

  • Insufficient permissions: the API user doesn’t have all the access. Add what the wizard lists and try again.
  • The connection fails on a trial account: enter the full address of the workspace instead of the subdomain alone.
  • The badge stays on To set up: check that each webhook has its trigger event and that the header carries the value shown in the block.
  • An interview isn’t linked to its application: link it by hand. See Link an interview to an application.
  • Sync stopped: the card shows the message returned by Nicoka. See My ATS isn’t syncing anymore.
If the problem persists, contact support with the interview concerned and the Nicoka IDs of the candidate and the job.

​
Disconnect Nicoka

In Settings, Integrations, click Disconnect on the Nicoka card. By default, data already synced is kept. Check the box in the confirmation window to delete it as well. Remember to delete the webhooks you created in Nicoka. See Disconnect a tool.

​
Good to know

  • An organization connects one ATS at a time.
  • The first import brings in twenty-four months of history.
  • Sharing the analysis to Nicoka doesn’t require a verdict.