Skip to main content
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": {
      "employmentCountry": "DE",
      "externalRef": "<string>",
      "startDate": "2023-12-25",
      "endDate": "2023-12-25",
      "birthDate": "2023-12-25",
      "birthPlace": "<string>",
      "birthCountry": "<string>",
      "personalEmail": "jsmith@example.com",
      "workEmail": "jsmith@example.com",
      "phoneNumbers": [
        {
          "phoneNumber": "<string>",
          "phoneType": "mobile",
          "isPrimary": true
        }
      ],
      "personalData": {
        "employmentCountry": "DE",
        "employeeName": {
          "familyName": "<string>",
          "givenName": "<string>",
          "familyNamePrefix": "<string>",
          "givenNameSuffix": "<string>",
          "birthName": "<string>",
          "birthFamilyNamePrefix": "<string>",
          "birthGivenNameSuffix": "<string>",
          "title": "<string>"
        },
        "gender": "M",
        "maritalStatus": "Single",
        "nationality": "German",
        "residenceAddress": "Taigschuster 11, 82380 Peissenberg, Germany",
        "statusIndicator": "managing_partner_gmbh_ug",
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25"
      },
      "relatedPersons": {
        "employmentCountry": "DE",
        "persons": [
          {
            "dependentName": {
              "familyName": "<string>",
              "givenName": "<string>",
              "familyNamePrefix": "<string>",
              "givenNameSuffix": "<string>",
              "birthName": "<string>",
              "birthFamilyNamePrefix": "<string>",
              "birthGivenNameSuffix": "<string>",
              "title": "<string>"
            },
            "dependentBirthDate": "2023-12-25",
            "relationshipProof": "<string>"
          }
        ],
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25"
      },
      "jobDetails": {
        "employmentCountry": "DE",
        "jobType": "Full Time Indefinite Term",
        "employmentStatus": "Employee",
        "isSeasonalWorker": true,
        "jobTitle": "<string>",
        "jobDescription": "<string>",
        "schoolEducation": "Ohne Schulabschluss",
        "professionalEducation": "Ohne beruflichen Ausbildungsabschluss",
        "occupationCode": "<string>",
        "contractedWeeklyHours": 123,
        "contractedToOtherCompany": false,
        "worksiteId": "<string>",
        "department": "<string>",
        "otherJobs": [
          {
            "employmentCountry": "DE",
            "employerName": "<string>",
            "employmentStartDate": "2023-12-25",
            "monthlyGrossIncome": 1
          }
        ],
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25"
      },
      "insuranceDetails": {
        "employmentCountry": "DE",
        "insuranceNumber": "12345678A123",
        "contributionGroup": "<string>",
        "personGroup": 101,
        "insuranceProvider": "<string>",
        "alternateCollectionAgency": "<string>",
        "privateInsuranceHealthMonthly": 1,
        "privateInsuranceCareMonthly": 1,
        "careInsuranceChildren": 2,
        "u1Exempt": true,
        "u2Exempt": true,
        "uvRiskTariff": [
          {
            "tariffCode": "<string>",
            "tariffDescription": "<string>",
            "tariffPercentage": 123
          }
        ],
        "pensionDetails": {
          "employmentCountry": "DE",
          "receivedMiningAdjustmentPayments": false,
          "pensionType": "full_old_age_pension_eu_eea_sva",
          "pensionStartDate": "2023-12-25",
          "waiverDeclarationStatus": "default",
          "waiverReceiptDate": "2023-12-25",
          "waiverValidityDate": "2023-12-25"
        },
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25",
        "birthDateContext": "2023-12-25"
      },
      "taxDetails": {
        "employmentCountry": "DE",
        "taxId": "<string>",
        "taxClass": "1",
        "childAllowances": 4.5,
        "churchConfession": "AK",
        "churchConfessionPartner": "AK",
        "factorProcedure": false,
        "factor": 499,
        "taxAllowanceAmount": 1,
        "additionalTaxableAmount": 1,
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25",
        "churchMember": false,
        "churchTaxState": "Baden-Württemberg"
      }
    },
    "bankAccounts": [
      {
        "financialInstitutionName": "Deutsche Bank",
        "accountNumber": "DE89370400440532013000",
        "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
required

Body

application/json · EmployeeRequest · object[]
employeeData
object
required

Country-specific employee data based on employment country Schema for German employee data.

  • GermanEmployee
  • GBEmployee
bankAccounts
BankAccountRequest · object[] | null

List of bank accounts associated with the employee

Response

Successful Response

The response is of type any.

I