New positions in Faculty Search can be created programmatically based on data from your institution's HRIS (Human Resources Information System) or ATS (Applicant Tracking System). Based on your implementation and desired workflow there are three common methods for creating a new position via the Faculty Search API. You may create a new position:

• “from scratch.”
• based on an existing position template.
• cloned from an existing position.

Create a position from scratch

The API endpoint for this purpose is: POST /{tenant_id}/positions

A POST to that end point may include a whole host of specific information about the position. Some of the most notable fields include:

• a name,
• description,
• application instructions,
• a job requisition number (from the HRIS/ATS), and
• whether the position should be published.

Many more additional fields are available and are listed in the end point documentation linked above. Additional calls to modify the applicant workflow may be necessary if additional steps or approval workflows are desired.

Create a position from a template

The API endpoint for this purpose is: POST /{tenant_id}/position_templates/{position_template_id}/to_position

Similar to position creation from scratch there are a number of fields that may be populated a the point of position creation. One benefit of creating a position from a template is that any workflow steps defined in the template will already be present in the newly created position.

In order to create a position from a template your integration will need to include a template ID in the path of the URL. That template ID may be obtained either from the address bar of the product UI when working with the desired template or programmatically by using the following API call: GET /{tenant_id}/position_templates.

Clone a position

The API endpoint for this purpose is: POST /{tenant_id}/positions/{id}/clone

Unlike the other options, cloning a position requires nothing more than the ID of the position you wish to clone. No other fields may be edited using this call. However, for any changes the newly cloned position may be modified or updated using the API call: PATCH /{tenant_id}/positions/{id}