Recruitee

The Recruitee connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores. is used to create connections for Recruitee actions A tool for building the processes, logic, and direction within workflows.. Use Recruitee actions to retrieve candidates, job offers, candidate pools, and to make a job offer within your workflow.

Create a Recruitee connection

You can create connections from the Automate or Designer page.

  1. On the top navigation bar, click Automate, and then select Connections from the left navigation.

  2. On the Connections page, click Add new.

  3. In the Add new section, select Recruitee as the connector.

  4. Click Connect.

  5. In the Configure a connection window, fill in the fields as follows.

    In this field

    Select or enter the following
    Connection name A name for your new connection
    Recruitee company ID Your Recruitee company identity number
    API Key The API Token, You can generate your own API Token under Settings > Apps and plugins > Personal API Tokens in Recruitee. You must insert "Bearer " before the key value, for example: Bearer dGVrSXg...

  6. Click Connect.

  7. Follow the prompts to enter credentials and grant access to Nintex Automation Cloud.

  8. In the permissions dialog, you can do one of the following:
    • Click Done to continue with the defaults.
    • Edit the connection Owners or Users permissions according to your access requirements and click Save permissions.

Your new connection appears on the Connections page.

    • On the top navigation bar, click Automate > Workflows, and then select the required workflow.

      • (Or)

    • On the top navigation bar, click Automate > Create workflow.
  2. Click the Recruitee action you want to add the connection to, or drag a Recruitee action into the workflow and select it.

  3. In the drop-down list for Connection, select Add new connection.

  4. In the Connection window, fill in the fields as follows.

    In this field

    Select or enter the following
    Connection name A name for your new connection
    Recruitee company ID Your Recruitee company identity number
    API Key The API Token, You can generate your own API Token under Settings > Apps and plugins > Personal API Tokens in Recruitee. You must insert "Bearer " before the key value, for example: Bearer dGVrSXg...

  5. Click Connect.

  6. Follow the prompts to enter credentials and grant access to Nintex Automation Cloud.

  7. In the permissions dialog, edit the connection Owners or Users permissions according to your access requirements and click Save permissions.

Your new connection appears in the Connection field of your action.

Assign permissions

Permissions enable you to manage access for other users to use, edit, and delete connections.

Note: By default, users with administrator role will have the same rights as a Connection owner.

  Use

Edit

 Delete

Assign
permissions

Owners
Users

Follow these steps to assign permissions from the Connections page:

  1. On the Connections page, click for the required connection.
  2. From the menu, select Permissions.
  3. To assign permissions:
    • In the Owners field, type the name of the user, and select from the list.
    • In the Users field, type the name of the user, and select from the list.
  1. Click Save permissions.

Create a Recruitee data source

Use the Recruitee data source to create a drop-down list of Recruitee candidates, job offers, or talent pools in a form.

Example:  To allow users to select a specific candidate in a form, add a drop-down list of candidates to the form using a Data lookup control A form control that allows users to select from a drop-down list of values that have been fetched from a third-party service.. The Data lookup control uses a Recruitee - Get candidates data source to list the candidates available from your Recruitee account in the drop-down.

You can create a data source to:

  • Get candidates: list all the candidates in your Recruitee account.
  • Get job offers: list all the job offers in your Recruitee account.
  • Get talent pools: list all the talent pools in your Recruitee account.

Each data source is configured for a specific user. You can create as many data sources as you need.

To add a Recruitee drop-down list to your form:

  1. Create your Recruitee data source.

    2. See Data sources.

  2. Add a data lookup form control to your form and configure it to use your new data source.

Assign data source permissions

Permissions enable you to manage access for other users to use, edit, and delete data sources.

  Use

Edit

 Delete

Assign
permissions

Connection owners

 ✔ ✔ ✔ ✔

Data source editors

 ✔ ✔ ✔ ✘
Data source users ✔ ✘ ✘ ✘

Note: By default, users with administrator role will have the same rights as a Connection owner.

Follow these steps to assign data source permissions from the Data sources page:

  1. On the Data sources page, click for the required data source.
  2. From the menu, select Permissions.

    3. The corresponding data source permissions window is displayed.

  3. To assign permissions:
    • In the Data source editors field, type the name of the user, and select from the list.
    • In the Data source users field, type the name of the user, and select from the list.
  1. Click Save Permissions.

Recruitee data source fields

When you create a Recruitee data source, you can configure some additional fields to specify which candidates, job offers, or talent pools the data source should retrieve.

Section

Field or selection

Description
Add new data source Operation Displays the operations available for the selected Connector. Depending on the selection the following fields are displayed:
  • Recruitee - Get candidates:
    • Limit: The number of candidates to retrieve.
    • Skip: The number of candidates to skip before returning the list.
    • Search Filters:
      • Created after: Retrieves candidates created after the configured data and time. You must use UTC formatting, such as 2020-12-08T16:02:38.752Z .
      • Disqualified: Retrieves candidates that are tagged as disqualified for at least one job offer.
      • Qualified: Retrieves candidates that are tagged as qualified for at least one job offer.
      • IDs: Retrieves a list of candidates based on their candidate IDs. You must separate each ID using a comma, such as 234221,4211412,535432.
      • Job offer: The job offer identity number.
  • Recruitee - Get job offers:
    • Scope: The condition of the job offers to return; active, archived, or not_archived.
  • Recruitee - Get talent pools:
    • Job status: The condition of the talent pool job type to return; active, archived, or not_archived.