Recruitee - Get candidates

Important: This connector and its actions have been removed from Nintex Workflow and can now be found in Nintex Gallery.

Use the Recruitee - Get candidates action to retrieve a list of candidates based on the search criteria configured in the action. The candidates retrieved are those available to the Recruitee account configured in the connection. For more information about Recruitee, go to Recruitee.

Before you begin: 

Jump to:

Configure the Recruitee - Get candidates action

  1. Add the action to the workflow and open the action configuration panel. For more information, see Add an action to the workflow.

  1. Select a Connection. If you do not have a connection, see Add a connection.
  2. Specify a Candidate.
  3. Create or select a variable for the Candidate details output.

Recruitee - Get candidates action fields and settings

Section

Field

Description

Variable types
(unlabeled)

Connection Credentials and other settings that enables workflows to communicate with external systems, services, or applications. It's required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store.

Recruitee connection to access the Recruitee account from which to retrieve the candidate information.

To refresh the available connections, click .

 (n/a)
  Limit The number of candidates to retrieve. Decimal, Integer
  Skip The number of candidates to skip before returning the list. Decimal, Integer
  Created after Retrieves candidates created after the configured data and time. You must use UTC formatting, such as 2020-12-08T16:02:38.752Z . Text, Integer, DateTime
  Disqualified Retrieves candidates that are tagged as disqualified for at least one job offer. Boolean
  Qualified Retrieves candidates that are tagged as qualified for at least one job offer. Boolean
  IDs Retrieves a list of candidates based on their candidate IDs. You must separate each ID using a comma, such as 234221,4211412,535432. Text, Decimal, Integer, Boolean, DateTime, Collection
  Job offer The job offer identity number. Decimal, Integer
Output Candidates

Stores the result of the action as an object with the following variables:

  • Candidates: (Object) Array of fields defining the retrieved candidates.

    • ID: (Decimal) The candidate's unique identifier.
    • Admin app URL: (Text) The dashboard overview URL for the candidate.
    • Created at: (Text) The date the candidate was added to Recruitee.
    • Emails: (Collections) Array of candidate's email addresses
    • Followed: (Boolean) True if token owner follows the candidate.
    • My last rating: (Text) The candidate's last rating.
    • My pending result request: (Boolean) True if the candidate has a pending status on a request.
    • My upcoming event: (Boolean) True if the candidate is placed in an upcoming event.
    • Name: (Text) Candidate's name.
    • Notes counting: (Decimal) The number of notes added to the candidate's profile.
    • Pending result request: (Boolean) True if the candidate has a pending status on a Recruitee request.
    • Phones: (Collection) Array of the candidate's phone numbers.
    • Photo thumbnail URL: (Text) URL link to the candidate's thumbnail image (jpg).
    • Photo URL: (Text) URL link to the candidate's profile image (jpg).
    • Placements: (Collection) Array of assignments to jobs or talent pools with stage information.
      • Created at: (Text) The date the position was created.
      • Offer ID: (Decimal) The position identifier.
      • Position: (Decimal) The title of the position.
      • Updated at: (Text) The date the position information was last updated.
    • Positive ratings: (Decimal) The number of positive ratings for the candidate.
    • Ratings count: (Decimal) The total number of ratings given for the candidate.
    • Referrer: (Text) Lists a candidate's referrers.
    • Source: (Text) List of sources added to candidate.
    • Tasks count: (Decimal)
    • Unread notifications: (Boolean) True if the candidate has any unread notifications.
    • Upcoming event: (Boolean) True if the candidate is listed in an upcoming event.
    • Updated at: (Text) The date the candidate profile was last updated
    • Viewed: (Boolean) True if the candidate's profile has been viewed.
  • Generated at: (DateTime) The time and date this Get candidates request was completed on.
 Object