> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bindbee.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Employee

> Creates an Employee object with the given values.

To create an employee in HRIS, you first need to fetch the request body structure that HRIS expects. This structure varies based on the HRIS provider (e.g., BambooHR, ADP, Workday). The request body consists of three parts:

* **Model Keys**: Standard attributes required for all employees.
* **Additional Attributes**: Specific fields required by the chosen HRIS.
* **Custom Fields**: Extra metadata for specific implementations.

**Note:** Some attributes may have `allowed_values`, meaning only specific values are permitted based on the customer's HRIS configuration. Ensure you check for these constraints before submitting the request.

## Step 1: Fetch the Required Request Body

Before calling the **Create Employee** API, you need to get the request structure using the [Meta Create Employee](/hris/employee/get-create-employee-meta) API.

## Step 2: Create an Employee

Once you have the request body structure, use the **Create Employee** API to send the request.


## OpenAPI

````yaml post /api/hris/v1/employees
openapi: 3.1.0
info:
  title: Bindbee APIs
  version: 0.1.0
servers:
  - url: https://api.bindbee.dev
  - url: https://api-eu.bindbee.dev
security: []
paths:
  /api/hris/v1/employees:
    post:
      tags:
        - Employee
      summary: Create Employee
      description: Creates an Employee object with the given values.
      operationId: create_employee_api_hris_v1_employees_post
      parameters:
        - name: x-idempotency-key
          in: header
          required: false
          schema:
            type: string
            description: Key to guarantee idempotent write execution.
            title: X-Idempotency-Key
          description: Key to guarantee idempotent write execution.
        - name: x-connector-token
          in: header
          required: true
          schema:
            type: string
            title: X-Connector-Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````