POST
/
organizations
/
{organization_id}
/
employees
Create Employees
curl --request POST \
  --url https://sandbox.intermezzo.ai/organizations/{organization_id}/employees \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "employeeData": {
      "birth_data": {
        "birth_country": "Germany",
        "birth_date": "1955-01-08",
        "birth_place": "Chemnitz"
      },
      "contact_information": {
        "mobile_number": "+49 170 1234567",
        "personal_email": "elisabeth@example.com",
        "phone_number": "+49 30 12345678",
        "work_email": "e.holgersson@company.de"
      },
      "employment_country": "DE",
      "external_ref": "EMP-2024-001",
      "insurance_details": {
        "care_insurance_children": 1,
        "contribution_group": "1111",
        "insurance_number": "12345678901",
        "insurance_provider": "99300660",
        "person_group": 101,
        "u1_exempt": false,
        "u2_exempt": false,
        "uv_risk_tariff": [
          {
            "tariff_code": "10",
            "tariff_description": "Bauwerksbau",
            "tariff_percentage": "100"
          }
        ],
        "valid_from": "2024-01-01"
      },
      "job_details": {
        "contracted_weekly_hours": 40,
        "department": "Engineering",
        "employment_status": "Employee",
        "job_description": "Development of backend services and APIs",
        "job_title": "Estrichleger",
        "job_type": "Full Time Indefinite Term",
        "occupation_code": "25213",
        "valid_from": "2024-01-15",
        "worksite_id": "wst_"
      },
      "personal_data": {
        "employee_name": {
          "birth_name": "de Angelo",
          "family_name": "Holgersson",
          "family_name_prefix": "auf dem",
          "given_name": "Elisabeth",
          "given_name_suffix": "Baronin",
          "title": "Dipl.-Volkswirt (FH)"
        },
        "gender": "F",
        "marital_status": "married",
        "nationality": "German",
        "residence_address": "Taigschuster 11, 82380 Peissenberg, Germany",
        "valid_from": "2024-01-01"
      },
      "related_persons": {
        "dependent_birth_date": "2018-03-10",
        "dependent_name": {
          "family_name": "Holgersson",
          "given_name": "Max"
        },
        "valid_from": "2024-01-15"
      },
      "start_date": "2024-01-15",
      "tax_details": {
        "additional_taxable_amount": "0.00",
        "child_allowances": "1.0",
        "church_confession": "RK",
        "church_member": true,
        "church_tax_state": "BE",
        "factor": 400,
        "factor_procedure": true,
        "tax_allowance_amount": "0.00",
        "tax_class": "3",
        "tax_id": "12345678901",
        "valid_from": "2024-01-01"
      }
    },
    "bankAccounts": [
      {
        "financialInstitutionName": "<string>",
        "accountNumber": "<string>",
        "routingNumber": "<string>",
        "iban": "<string>",
        "isActive": true,
        "isPrimary": false
      }
    ]
  }
]'
"<any>"

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organization_id
string
required

TypeID with prefix 'org'

Example:

"org_01h455vb4pex5vsknk084sn02q"

Body

application/json · EmployeeRequest · object[]

The body is of type EmployeeRequest · object[].

Response

Successful Response

The response is of type any.