> ## Documentation Index > Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create employee with form > Create an employee, based on the form schema. This feature is currently available for the following integrations:

You'd like to see this feature for another integration? Please reach out! We're always happy to discuss extending our coverage. This endpoint requires the permission **Create and manage employees** to be enabled in [your scope config](/scopes). ### Example Request Body ```json { "staffing_entity_id": "26vafvWSRmbhNcxJYqjCzuJg", "properties": { "firstName": "John", "startDate": "2025-01-01", "workLocation": { "site": "8e422bf8cav", "keyNumbers": [ 142, 525, 63 ] } } } ``` operationId: PostHrisEmployeesForm parameters: - in: header name: X-Integration-Id schema: type: string description: ID of the integration you want to interact with. example: bamboohr:HWUTwvyx2wLoSUHphiWVrp28 required: true requestBody: description: POST /hris/employees/form Request body content: application/json: schema: $ref: '#/components/schemas/PostHrisEmployeesFormRequestBody' examples: example1: value: staffing_entity_id: 26vafvWSRmbhNcxJYqjCzuJg properties: firstName: John startDate: '2025-01-01' workLocation: site: 8e422bf8cav keyNumbers: - 142 - 525 - 63 responses: '200': description: POST /hris/employees/form Positive response content: application/json: schema: $ref: '#/components/schemas/PostHrisEmployeesFormPositiveResponse' examples: example1: value: status: success data: id: 26vafvWSRmbhNcxJYqjCzuJg remote_id: '12345' prehire: remote_id: null warnings: - message: This is an example warning! default: $ref: '#/components/responses/ErrorResponseHRIS' x-codeSamples: - lang: python label: PostHrisEmployeesForm source: |- from kombo import Kombo with Kombo( integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28", api_key="", ) as k_client: res = k_client.hris.create_employee_with_form(properties={ "firstName": "John", "startDate": "2025-01-01T00:00:00Z", "workLocation": { "site": "8e422bf8cav", "keyNumbers": { "0": 142, "1": 525, "2": 63, }, }, }, staffing_entity_id="26vafvWSRmbhNcxJYqjCzuJg") # Handle response print(res) - lang: typescript label: PostHrisEmployeesForm source: |- import { Kombo } from "@kombo-api/sdk"; const kombo = new Kombo({ integration_id: "workday:HWUTwvyx2wLoSUHphiWVrp28", api_key: "", }); async function run() { const result = await kombo.hris.createEmployeeWithForm({ staffing_entity_id: "26vafvWSRmbhNcxJYqjCzuJg", properties: { "firstName": "John", "startDate": "2025-01-01T00:00:00Z", "workLocation": { "site": "8e422bf8cav", "keyNumbers": { "0": 142, "1": 525, "2": 63, }, }, }, }); console.log(result); } run(); - lang: ruby label: PostHrisEmployeesForm source: >- require 'kombo' Models = ::Kombo::Models s = ::Kombo::Kombo.new( integration_id: 'workday:HWUTwvyx2wLoSUHphiWVrp28', security: Models::Shared::Security.new( api_key: '' ) ) res = s.hris.create_employee_with_form(body: Models::Shared::PostHrisEmployeesFormRequestBody.new( staffing_entity_id: '26vafvWSRmbhNcxJYqjCzuJg', properties: { 'firstName' => 'John', 'startDate' => '2025-01-01T00:00:00Z', 'workLocation' => { 'keyNumbers' => { '0' => 142.0, '1' => 525.0, '2' => 63.0, }, 'site' => '8e422bf8cav', }, } )) unless res.post_hris_employees_form_positive_response.nil? # handle response end components: schemas: PostHrisEmployeesFormRequestBody: type: object properties: staffing_entity_id: type: string minLength: 24 maxLength: 24 pattern: ^[1-9A-HJ-NP-Za-km-z]+$ properties: $ref: '#/components/schemas/Schema3' required: - properties PostHrisEmployeesFormPositiveResponse: type: object properties: status: type: string const: success data: type: object properties: id: type: - string - 'null' description: >- The Kombo id of the created employee. If null, we only created a pre-hire which shows up in the next sync after a successful onboarding. remote_id: type: - string - 'null' description: >- The raw ID of the created employee in the remote system. This is only populated when `id` is set (i.e., when a full employee was created). For pre-hires, use the `prehire` object instead. prehire: type: object properties: remote_id: type: - string - 'null' description: >- The temporary ID returned by the remote system when creating a pre-hire. required: - remote_id description: >- An object containing the temporary pre-hire information from the remote system. This ID may change or become invalid when the pre-hire becomes a full employee. Only populated when `id` is null. required: - id - remote_id - prehire examples: - id: 26vafvWSRmbhNcxJYqjCzuJg remote_id: '12345' prehire: remote_id: null warnings: type: array items: type: object properties: message: type: string required: - message description: >- These are the interaction warnings that are shown in the dashboard. They are meant to provide debug information to you. We recommend logging them to the console. required: - status - data - warnings Schema3: type: object additionalProperties: $ref: '#/components/schemas/Schema4' Schema4: oneOf: - type: string - type: number format: double minimum: -1.7976931348623157e+308 - type: boolean - $ref: '#/components/schemas/Schema5' - $ref: '#/components/schemas/Schema6' Schema5: type: object additionalProperties: $ref: '#/components/schemas/Schema4' Schema6: type: array items: $ref: '#/components/schemas/Schema4' responses: ErrorResponseHRIS: description: The standard error response with the error codes for the HRIS use case. content: application/json: schema: type: object properties: status: type: string enum: - error error: type: object properties: code: type: - string - 'null' enum: - PLATFORM.RATE_LIMIT_EXCEEDED - PLATFORM.CONCURRENCY_LIMIT_EXCEEDED - PLATFORM.INTEGRATION_NOT_FOUND - PLATFORM.INPUT_INVALID - PLATFORM.UNKNOWN_ERROR - PLATFORM.IP_NOT_WHITELISTED - PLATFORM.AUTHENTICATION_INVALID - PLATFORM.TASK_TIMED_OUT - INTEGRATION.PERMISSION_MISSING - INTEGRATION.AUTHENTICATION_INVALID - INTEGRATION.QA_FAILED - INTEGRATION.SETUP_SYNC_PENDING - INTEGRATION.SETUP_INCOMPLETE - INTEGRATION.INACTIVE - INTEGRATION.MODEL_NOT_AVAILABLE - INTEGRATION.MODEL_DISABLED - INTEGRATION.ACTION_NOT_AVAILABLE - INTEGRATION.ACTION_DISABLED - REMOTE.SERVICE_UNAVAILABLE - REMOTE.RATE_LIMIT_EXCEEDED - REMOTE.INPUT_INVALID - REMOTE.UNKNOWN_HTTP_ERROR - HRIS.STAFFING_ENTITY_CLOSED - HRIS.EMPLOYEE_ALREADY_EXISTS example: HRIS.EMPLOYEE_ALREADY_EXISTS description: >- Some errors include an error code that can be used to identify their cause. See the [Error Handling Docs](https://docs.kombo.dev/guides/errors) for more information. For your error handling logic please use the error `code` instead of other properties (e.g. message, http status code, ...). title: type: - string - 'null' description: A static, human-readable label. message: type: string description: >- A dynamic, detailed description of what went wrong in this specific instance. log_url: type: - string - 'null' format: uri description: >- The log page in the Kombo UI lists every interaction with full details. If you need assistance, share that link with our support team. required: - code - title - message - log_url description: Error details with structured code for programmatic handling. required: - status - error examples: Error Response: description: >- When building error handling logic, always use the `code` field to identify specific error types programmatically. See the complete list of error codes in the [docs](https://docs.kombo.dev/guides/errors). value: status: error error: code: INTEGRATION.MODEL_NOT_AVAILABLE title: >- This data model isn't supported for the selected integration. message: >- The "employees" model is not yet available for Greenhouse. Please reach out to Kombo if you need this functionality. log_url: https://app.kombo.dev/my-prod/logs?interactionId=123456 Minimal Error Response: description: >- The "message" is always required while other fields can also be `null`. See the [docs](https://docs.kombo.dev/guides/errors) for more information. value: status: error error: code: null title: null message: The message is always in the response. log_url: null securitySchemes: ApiKey: type: http scheme: bearer description: >- Create an API key on the [Secrets](https://app.kombo.dev/secrets) page in the Kombo dashboard. ````