Add a Connection to Comeet in Engini
Prerequisites
- A Comeet account.
- A Comeet API Token.
Connecting Engini to Comeet
- Enter your Engini account at https://app.engini.io.
-
Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here.

-
Click on the “New Integration” option located at the top bar.

-
Choose the Comeet option from the available applications.

-
Enter the following details in the “New Integration” form and press Save:

- 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.
- API Token - Enter your Comeet API Token.
- 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.
- Starting (UTC) - Choose the date and time for this workflow to start working. From that time the workflow runs according to the selected frequency.
- Recur every - Select the time interval. The minimum time interval is 15 minutes.
- 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.
- 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.
- URL - Copy the URL and paste it in the relevant place in Comeet.
- 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.
- URL - Copy the URL and paste it in the relevant place in Comeet.
- 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.
- URL - Copy the URL and paste it in the relevant place in Comeet.
- 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.
- 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.
- 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.
- 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.
- 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.
- Position U I D - Enter the UID of the position whose candidates you want to get.
Create Candidate
Creates a candidate for a position.
- Position U I D - Enter the unique ID of the position.
- Partner Candidate Id - Enter the unique ID of the candidate in the partner’s system.
- First Name - Enter the first name of the candidate.
- Last Name - Enter the last name of the candidate.
- 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.
- Candidate U I D - Enter the UID of the candidate you want to update.
- Updated By - Type - Select who made the update.
- Updated By - Name - Enter the name of who made the update.
- 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.
- Candidate U I D - Enter the UID of the candidate.
- Time Created - Enter the time the note was created, in the format YYYY-MM-DDTHH:mm:ssZ.
- 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.
- 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.
- 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.
- Position UID - Enter the UID of the position you want to get. You can find it with the Get Positions action.
- Include - Optional. Select extra data to include in the response. You can choose one or more of the following:
- Details
- Internal Requirements
Create a Position
Creates a new position.
- Name - Enter the name of the position.
- Status - Select the status of the position: open, on hold or closed.
- Is Discreet - Select true or false. True means that the position is visible only to teammates on the position’s hiring team.
- 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.
- 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.
- Position Uid - Enter the unique ID of the position.
- Name - Enter the name of the opening.
- Reason - Select the reason for the opening: New, Replacement hire or Temporary replacement.
- Status - Select the status of the opening.
- 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.
Delete a Person
Deletes a person.
- Person Id (uid) - Enter the ID of the person you want to delete.
Pseudonymize a Person
Pseudonymizes a person, removing their personally identifiable information.
- 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.
- 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.
- Variable - Choose the files array variable you want to add to.
- Name - Enter the name of the file you append.
- File - Enter the file content. It must be in base64 format.
Initialize Links Array
Creates and sets up an array of links.
- Name - Enter a name for the array. You can name it according to your use case.
Append to Links Array
Adds a link to an existing links array.
- Variable - Choose the links array variable you want to add to.
- 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.
- Variable Name - By default the name is “Hiring Manager”. You can rename it according to your use case.
- Email - Enter the email of the hiring manager.
Initialize Lead Recrutier
Creates a Lead Recruiter object that you can use in other steps.
- Variable Name - By default the name is “lead recrutier”. You can rename it according to your use case.
- Email - Enter the email of the lead recruiter.
Initialize Recruiting Coordinator
Creates a Recruiting Coordinator object that you can use in other steps.
- Variable Name - By default the name is “Recruiting Coordinator”. You can rename it according to your use case.
- Email - Enter the email of the recruiting coordinator.
Initialize Position Categories Array
Creates and sets up an array of position categories.
- 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.
- Variable - Choose the categories array variable you want to add to.
- 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.
- Base Url - The root URL of the API you are sending the request to.
- Relative url - Path segments or parameters to add to the end of the base URL, to customize the request.
- Method - Select the HTTP method (for example Get, Post, Put, Delete, Patch).
- Body Type - The format of the data in the body of your request, for example application/json.
- Body - The data you send to the server.
- Add Headers - Additional metadata about the request, such as the type of data Engini can accept and authentication information.
- Add Queries - Parameters added to the URL of the request to give the server additional information or instructions.