Plan: Enterprise
Comeet's APIs offer you the ability to create a seamless integration between Comeet and your Human Resource Information System (HRIS). This article provides guidelines for the following common use cases:
New hires—Create new employee profiles in your HRIS and associate them with a position. You can customize the hire form in Comeet with specific fields from your HRIS.
New positions—Create new positions in Comeet when approved in the HRIS.
Retrieving statuses—Sync recruiting status from Comeet to your HRIS.
Note: Each of the following options can be implemented separately, allowing you to tailor the integration to your requirements. We recommend starting with syncing new hires—it's not only the most straightforward but also yields the most immediate impact. It improves the productivity of the HR team and eliminates the possibility of human error.
New hires
Implementation time | 1–2 weeks |
Integration type | Create a service that relays data between Comeet and your HRIS in real time |
Comeet API | |
Get started |
Implement the Hires API to create new employee profiles in the HRIS when hires are made in Comeet. Beyond saving time for the HR team, this integration ensures consistent synchronization with correct data.
Keep everything in sync: When a hire is made in Comeet, Comeet makes a request to create an employee webhook to generate the new employee profile in the HRIS. The status of the candidate in Comeet can only be changed to Hired when the request to create the new employee profile in the HRIS is completed successfully.
Customize hire forms: You can customize the hire form in Comeet to request that the recruiter fill out additional information to complete the hire. This is especially useful for certain fields, like Gender, that are required for creating the new employee profile but are not managed in Comeet as part of the recruiting process. It is also useful when creating a new employee requires values that are associated with entities that are managed in the HRIS, such as Business unit or Direct manager. To get started with customizing the hire form, see the reference for the Request hire questionnaire webhook.
Associate employee profiles with positions: You can use the candidate data provided in the request to associate the new hire with the position or requisition in the HRIS. You can do this in one of two ways:
One option is to ask the recruiter to select the right position when making the hire by adding a positions dropdown to the hire form. See this reference with instructions for customizing the hire form.
You can also do this programmatically if you create new positions in Comeet using the API. When creating new positions and openings in Comeet, you can store the unique identifier of the position in the HRIS as part of the opening object in Comeet. When the hire is made, use this identifier to update the status of the position in the HRIS.
Facilitate internal mobility: In cases where existing company employees are hired for other roles in the company, you should update the existing employee profile instead of creating a new employee. You can implement this type of update using the API or choose to instruct the HR team to make such changes manually since these types of hires are not common and would typically require manual updates in the HRIS that cannot all be automated.
Include offer details: If you’re using Comeet Offer Letters, you can choose to include details from the Offer steps as part of the information sent after each completed hire, including:
A link to the Offer Letter, if it exists in Comeet: This is included by default but you can check it off.
Offer details for the candidate: This includes both default and custom attributes used in the Offer Letter.
Details for internal approval only: This includes the attributes used in the internal approval process.
New positions
Implementation time | 1–2 weeks |
Integration type | Run a periodic process that creates new positions and openings in Comeet when they are approved in the HRIS |
Comeet API | |
Get started |
When new positions and openings (also referred to as requisitions) are approved in the HRIS, they can be seamlessly created in Comeet using the Recruiting API.
New positions: You can create new positions with single or multiple openings using the Create a Position endpoint.
New openings: You can create new openings for existing positions using the Create an Opening endpoint.
Store the HRIS ID: When creating a new position or opening, it is recommended to store in Comeet the unique identifier that identifies the position in the HRIS. You can create a custom opening field in Comeet for storing this identifier (for example, “HRIS ID”). This allows you to associate new hires with the relevant position in the HRIS by using this identifier.
Note: After positions and openings are created in Comeet, any subsequent changes should be made in Comeet and not in the HRIS. Such changes can be synced back to the HRIS by retrieving the current statuses as explained in the following use case.
❓ What’s the difference between a position and an opening?
Each position in Comeet can have multiple openings, where each opening represents a single vacancy. This is useful when hiring multiple people for the same role, either at the same time or over some time.
Retrieving statuses
Implementation time | 1–2 weeks |
Integration type | Run a periodic process that pulls up-to-date data from Comeet and updates statuses in the HRIS |
Comeet API | |
Get started |
Leverage the Recruiting API to sync current recruiting statuses with your HRIS. While hires are synced with the HRIS in real time, other changes—such as updates to timelines or canceled openings—can be retrieved and updated separately in the HRIS.
This allows you to create dashboards and reports in your HRIS with insights into the status of your hiring processes in relation to the approved hiring plan.
Pull current statuses: To capture the latest updates in Comeet, you can use the List Positions and List Openings endpoints, and apply the
time_updated:afterfilter to retrieve changes made since the last execution of the update process.
Have more questions? Contact us at support@comeet.co