Skip to main content
Learn how to connect Engini to Comeet. With the Comeet activities in Engini you can follow changes to candidates, openings and positions, create and update them, and look up people and locations, directly from your workflows.

Add a Connection to Comeet in Engini

Prerequisites

  • A Comeet account.
  • A Comeet API Token.

Connecting Engini to Comeet

  1. Enter your Engini account at https://app.engini.io.
  2. Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here. Engini - Connections page
  3. Click on the “New Integration” option located at the top bar. Engini - New Integration button
  4. Choose the Comeet option from the available applications. Comeet - Choose Application
  5. Enter the following details in the “New Integration” form and press Save: Comeet - New Integration form
  6. Connection Name - Enter a unique and descriptive name for this connection. This name helps you identify and manage the connection in your Engini account. “Comeet” by default.
  7. API Token - Enter your Comeet API Token.
  8. Save - Click Save to create the connection.

Triggers

Check Triggers

The Check triggers look for changes in Comeet at the schedule you set, and start the workflow for each item that changed since the previous run.
  • Check for Candidate Created: Checks if a candidate was created.
  • Check for Candidate Updated: Checks if the information of an existing candidate was updated.
  • Check for Candidate Status Changed: Checks if the status of a candidate changed.
  • Check for Opening Created: Checks if an opening was created.
  • Check for Opening Updated: Checks if the information of an existing opening was updated.
  • Check for Opening Status Changed: Checks if the status of an opening changed.
  • Check for Position Updated: Checks if the information of an existing position was updated.
Set the schedule of the trigger:
  1. Starting (UTC) - Choose the date and time for this workflow to start working. From that time the workflow runs according to the selected frequency.
  2. Recur every - Select the time interval. The minimum time interval is 15 minutes.
  3. Add time frame - Click “Add time frames” to select the specific time frame during which you want your workflow to run. Select the start time and end time that fit your schedule, and click “Add time frame” again to add more time frames. Next Run at - You will see the date and time of the next run, in UTC and in your local time.
  4. Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Position Created

The Position Created trigger starts the workflow when a position is created in Comeet. Comeet - Position Created trigger
  1. URL - Copy the URL and paste it in the relevant place in Comeet.
  2. Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Position Updated

The Position Updated trigger starts the workflow when a position is updated in Comeet. Comeet - Position Updated trigger
  1. URL - Copy the URL and paste it in the relevant place in Comeet.
  2. Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Position Deleted

The Position Deleted trigger starts the workflow when a position is deleted in Comeet. Comeet - Position Deleted trigger
  1. URL - Copy the URL and paste it in the relevant place in Comeet.
  2. Add Conditions - Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Actions

Get Candidates

Gets all the candidates who meet the conditions. Comeet - Get Candidates action
  • Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Get Candidate

Gets one candidate by UID. Comeet - Get Candidate action
  • U I D - Enter the UID of the candidate you want to get.

Get Deleted Candidates

Gets all the deleted candidates who meet the conditions. Comeet - Get Deleted Candidates action
  • Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Find Duplicate Candidates

The response includes an array of candidates that were detected as possible duplicates. Comeet - Find Duplicate Candidates action
  • Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Get Candidates by Position

Gets the candidates of a position. Comeet - Get Candidates by Position action
  • Position U I D - Enter the UID of the position whose candidates you want to get.

Create Candidate

Creates a candidate for a position. Comeet - Create Candidate action
  1. Position U I D - Enter the unique ID of the position.
  2. Partner Candidate Id - Enter the unique ID of the candidate in the partner’s system.
  3. First Name - Enter the first name of the candidate.
  4. Last Name - Enter the last name of the candidate.
  5. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

Update Candidate

Updates an existing candidate. Comeet - Update Candidate action
  1. Candidate U I D - Enter the UID of the candidate you want to update.
  2. Updated By - Type - Select who made the update.
  3. Updated By - Name - Enter the name of who made the update.
  4. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

Create a Candidate Note

Creates a note on an existing candidate. Use it to add information about the candidate or to document an event on the candidate profile. Comeet - Create a Candidate Note action
  1. Candidate U I D - Enter the UID of the candidate.
  2. Time Created - Enter the time the note was created, in the format YYYY-MM-DDTHH:mm:ssZ.
  3. Text - Enter the note text. HTML is supported with the tags <b>, <i> and <u>. For security reasons other tags are removed or shown as text.
  4. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

Get Positions

Gets all the positions who meet the conditions. Comeet - Get Positions action
  • Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Get a Specific Position (Private)

Retrieves a single position by its UID using Comeet’s private (authenticated) API. Comeet - Get a Specific Position (Private) action
  1. Position UID - Enter the UID of the position you want to get. You can find it with the Get Positions action.
  2. Include - Optional. Select extra data to include in the response. You can choose one or more of the following:
    • Details
    • Internal Requirements
Note: Including Internal Requirements requires additional permissions in Comeet.

Create a Position

Creates a new position. Comeet - Create a Position action
  1. Name - Enter the name of the position.
  2. Status - Select the status of the position: open, on hold or closed.
  3. Is Discreet - Select true or false. True means that the position is visible only to teammates on the position’s hiring team.
  4. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

Get Openings

Gets all the openings who meet the conditions. Comeet - Get Openings action
  • Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.

Create an Opening

Creates a new opening for a position. Comeet - Create an Opening action
  1. Position Uid - Enter the unique ID of the position.
  2. Name - Enter the name of the opening.
  3. Reason - Select the reason for the opening: New, Replacement hire or Temporary replacement.
  4. Status - Select the status of the opening.
  5. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.

Get Locations

Gets the locations defined in Comeet. This action has no fields to fill in. Comeet - Get Locations action

Delete a Person

Deletes a person. Comeet - Delete a Person action
  • Person Id (uid) - Enter the ID of the person you want to delete.

Pseudonymize a Person

Pseudonymizes a person, removing their personally identifiable information. Comeet - Pseudonymize a Person action
  • Person I D (uid) - Enter the ID of the person you want to pseudonymize.

Initialize Files Array

Creates and sets up an array of files. Comeet - Initialize Files Array action
  • Name - By default the array is named “files array”. You can rename it according to your use case.

Append to Files Array

Adds a file to an existing files array. Comeet - Append to Files Array action
  1. Variable - Choose the files array variable you want to add to.
  2. Name - Enter the name of the file you append.
  3. File - Enter the file content. It must be in base64 format.
Creates and sets up an array of links. Comeet - Initialize Links Array action
  • Name - Enter a name for the array. You can name it according to your use case.
Adds a link to an existing links array. Comeet - Append to Links Array action
  1. Variable - Choose the links array variable you want to add to.
  2. U R L - Enter the URL you append to the array.

Initialize Hiring Manager Object

Creates a Hiring Manager object that you can use in other steps. Comeet - Initialize Hiring Manager Object action
  1. Variable Name - By default the name is “Hiring Manager”. You can rename it according to your use case.
  2. Email - Enter the email of the hiring manager.

Initialize Lead Recrutier

Creates a Lead Recruiter object that you can use in other steps. Comeet - Initialize Lead Recrutier action
  1. Variable Name - By default the name is “lead recrutier”. You can rename it according to your use case.
  2. Email - Enter the email of the lead recruiter.

Initialize Recruiting Coordinator

Creates a Recruiting Coordinator object that you can use in other steps. Comeet - Initialize Recruiting Coordinator action
  1. Variable Name - By default the name is “Recruiting Coordinator”. You can rename it according to your use case.
  2. Email - Enter the email of the recruiting coordinator.

Initialize Position Categories Array

Creates and sets up an array of position categories. Comeet - Initialize Position Categories Array action
  • Variable Name - By default the array is named “Categories”. You can rename it according to your use case.

Append to Categories Array

Adds a category to an existing position categories array. Comeet - Append to Categories Array action
  1. Variable - Choose the categories array variable you want to add to.
  2. Add Field - Click Add Field to add and populate additional fields for the category. To learn more about managing activity data, click here.

Send Api Request

Sends a custom request to the Comeet API. Comeet - Send Api Request action
  1. Base Url - The root URL of the API you are sending the request to.
  2. Relative url - Path segments or parameters to add to the end of the base URL, to customize the request.
  3. Method - Select the HTTP method (for example Get, Post, Put, Delete, Patch).
  4. Body Type - The format of the data in the body of your request, for example application/json.
  5. Body - The data you send to the server.
  6. Add Headers - Additional metadata about the request, such as the type of data Engini can accept and authentication information.
  7. Add Queries - Parameters added to the URL of the request to give the server additional information or instructions.