Linking your Carerix account (GraphQL)

How to link your Carerix account to Wintro through the Carerix GraphQL API?

Carerix is retiring its legacy REST API and recommends the GraphQL API for all new integrations. New Wintro customers connect through GraphQL. If your company already has a working Carerix connection in Wintro, nothing changes for you.

Prerequisites

You need a Carerix user with access to Maintenance → Identity Access. This is normally a Carerix administrator.

The connection flow asks for three values from Carerix:

• the OpenID Configuration URL
• a Client ID
• a Client Secret

Keep the Wintro connection flow open in a separate browser tab. You paste the values into it as you go.

Instructions

1. Open Identity Access. In Carerix, go to Maintenance → Identity Access in the left sidebar and open the CLIENTS tab.

   

2. Copy the OpenID Configuration URL. On the CLIENTS tab, click OpenID Configuration. Carerix opens the configuration in a new tab, at an address that looks like https://id-s3.carerix.io/auth/realms/<your-realm>/.well-known/openid-configuration. Copy the full URL from the address bar and paste it into the OpenID Configuration URL field of the connection flow.

   

   

3. Create a confidential client. Back on the CLIENTS tab, click New and choose Confidential. Pick Confidential, not Public: a confidential client authenticates with a secret as a standalone service, which is what the integration needs.

   

4. Fill in the client form.

   • Name: a recognisable name, for example wintro.
   • Code: use the suggested format urn:{vendor}/{unique name}, for example urn:wintro/referrals.
   • Default scopes: add the scopes listed in the Wintro connection flow.
   • Active: Yes.

   Click Save.

   

5. Copy the Client ID and Client Secret. After saving, Carerix shows the new Client ID and Client Secret. Paste both into the matching fields of the connection flow. The secret is shown once, so copy it before leaving the page.

   

6. Submit the connection flow. With all three values entered, submit to finish connecting. Wintro starts syncing your vacancies within the hour.

Tracking hires and rejections

Wintro reads the outcome of a referral directly from Carerix. For that to work, the match stages you use for a hire and for a rejection must be marked as final stages in Carerix:

1. Go to Maintenance → Match stages and open the stage that represents a hire (for example your “client hires candidate” or “placement” stage).
2. Set Final stage to Yes and Match process is finished successfully to Yes.
3. Open each stage that represents a rejection and set Final stage to Yes, leaving Match process is finished successfully at No.

Stages without the final flag are treated as still in progress. These are the same flags Carerix uses for its own successful and unsuccessful funnel groups, so most accounts already have them set.

Entry stage

In Wintro, under Settings → Integrations → Entry stage mapping, choose the Carerix match stage that new referrals should be created in. Carerix match stages are shared across all job orders, so one choice applies everywhere.

Good to know

• Tags are not supported by Carerix. Wintro adds a note to the application with the referrer and a link to the candidate passport instead.
• Documents such as a CV are stored on the candidate in Carerix, not on the individual application.
• Wintro syncs vacancies and candidates from Carerix every hour.