Skip to main content
POST
/
organizations
/
{organization_id}
/
employees
Create Employees
curl --request POST \
  --url https://preview.intermezzo.ai/organizations/{organization_id}/employees \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "employeeData": {
      "birthDate": "2023-12-25",
      "employmentCountry": "DE",
      "externalRef": "<string>",
      "startDate": "2023-12-25",
      "endDate": "2023-12-25",
      "birthPlace": "<string>",
      "birthCountry": "<string>",
      "personalEmail": "jsmith@example.com",
      "workEmail": "jsmith@example.com",
      "phoneNumbers": [
        {
          "phoneNumber": "<string>",
          "isPrimary": false
        }
      ],
      "personalData": {
        "employeeName": {
          "familyName": "<string>",
          "givenName": "<string>",
          "familyNamePrefix": "<string>",
          "givenNameSuffix": "<string>",
          "birthName": "<string>",
          "birthFamilyNamePrefix": "<string>",
          "birthGivenNameSuffix": "<string>",
          "title": "<string>"
        },
        "employmentCountry": "DE",
        "nationality": "German",
        "residenceAddress": "Taigschuster 11, 82380 Peissenberg, Germany",
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25"
      },
      "relatedPersons": {
        "persons": [
          {
            "dependentName": {
              "familyName": "<string>",
              "givenName": "<string>",
              "familyNamePrefix": "<string>",
              "givenNameSuffix": "<string>",
              "birthName": "<string>",
              "birthFamilyNamePrefix": "<string>",
              "birthGivenNameSuffix": "<string>",
              "title": "<string>"
            },
            "dependentBirthDate": "2023-12-25",
            "relationshipProof": "<string>"
          }
        ],
        "employmentCountry": "DE",
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25"
      },
      "jobDetails": {
        "employmentCountry": "DE",
        "isSeasonalWorker": false,
        "jobTitle": "<string>",
        "jobDescription": "<string>",
        "occupationCode": "<string>",
        "contractedWeeklyHours": 40,
        "contractedWeekdays": [],
        "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>",
        "insuranceProvider": "<string>",
        "alternateCollectionAgency": "<string>",
        "privateInsuranceHealthMonthly": "0",
        "privateInsuranceCareMonthly": "0",
        "careInsuranceChildren": 0,
        "u1Exempt": true,
        "u2Exempt": true,
        "uvRiskTariff": [
          {
            "tariffCode": "<string>",
            "tariffDescription": "<string>",
            "tariffPercentage": "0"
          }
        ],
        "pensionDetails": {
          "employmentCountry": "DE",
          "receivedMiningAdjustmentPayments": false,
          "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": {
        "taxId": "<string>",
        "employmentCountry": "DE",
        "childAllowances": "0.0",
        "factorProcedure": false,
        "factor": 499,
        "taxAllowanceAmount": 1,
        "additionalTaxableAmount": 1,
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25",
        "churchMember": false
      }
    },
    "bankAccounts": [
      {
        "financialInstitutionName": "<string>",
        "accountNumber": "DE: DE89370400440532013000",
        "routingNumber": "DE: 370400440",
        "iban": "DE: DE89370400440532013000",
        "swiftCode": "DE: COBADEFFXXX",
        "accountDetails": {},
        "isActive": true,
        "isPrimary": false
      }
    ],
    "payGroupId": "<string>"
  }
]
'
import requests

url = "https://preview.intermezzo.ai/organizations/{organization_id}/employees"

payload = [
    {
        "employeeData": {
            "birthDate": "2023-12-25",
            "employmentCountry": "DE",
            "externalRef": "<string>",
            "startDate": "2023-12-25",
            "endDate": "2023-12-25",
            "birthPlace": "<string>",
            "birthCountry": "<string>",
            "personalEmail": "jsmith@example.com",
            "workEmail": "jsmith@example.com",
            "phoneNumbers": [
                {
                    "phoneNumber": "<string>",
                    "isPrimary": False
                }
            ],
            "personalData": {
                "employeeName": {
                    "familyName": "<string>",
                    "givenName": "<string>",
                    "familyNamePrefix": "<string>",
                    "givenNameSuffix": "<string>",
                    "birthName": "<string>",
                    "birthFamilyNamePrefix": "<string>",
                    "birthGivenNameSuffix": "<string>",
                    "title": "<string>"
                },
                "employmentCountry": "DE",
                "nationality": "German",
                "residenceAddress": "Taigschuster 11, 82380 Peissenberg, Germany",
                "validFrom": "2023-12-25",
                "validTo": "2023-12-25"
            },
            "relatedPersons": {
                "persons": [
                    {
                        "dependentName": {
                            "familyName": "<string>",
                            "givenName": "<string>",
                            "familyNamePrefix": "<string>",
                            "givenNameSuffix": "<string>",
                            "birthName": "<string>",
                            "birthFamilyNamePrefix": "<string>",
                            "birthGivenNameSuffix": "<string>",
                            "title": "<string>"
                        },
                        "dependentBirthDate": "2023-12-25",
                        "relationshipProof": "<string>"
                    }
                ],
                "employmentCountry": "DE",
                "validFrom": "2023-12-25",
                "validTo": "2023-12-25"
            },
            "jobDetails": {
                "employmentCountry": "DE",
                "isSeasonalWorker": False,
                "jobTitle": "<string>",
                "jobDescription": "<string>",
                "occupationCode": "<string>",
                "contractedWeeklyHours": 40,
                "contractedWeekdays": [],
                "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>",
                "insuranceProvider": "<string>",
                "alternateCollectionAgency": "<string>",
                "privateInsuranceHealthMonthly": "0",
                "privateInsuranceCareMonthly": "0",
                "careInsuranceChildren": 0,
                "u1Exempt": True,
                "u2Exempt": True,
                "uvRiskTariff": [
                    {
                        "tariffCode": "<string>",
                        "tariffDescription": "<string>",
                        "tariffPercentage": "0"
                    }
                ],
                "pensionDetails": {
                    "employmentCountry": "DE",
                    "receivedMiningAdjustmentPayments": False,
                    "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": {
                "taxId": "<string>",
                "employmentCountry": "DE",
                "childAllowances": "0.0",
                "factorProcedure": False,
                "factor": 499,
                "taxAllowanceAmount": 1,
                "additionalTaxableAmount": 1,
                "validFrom": "2023-12-25",
                "validTo": "2023-12-25",
                "churchMember": False
            }
        },
        "bankAccounts": [
            {
                "financialInstitutionName": "<string>",
                "accountNumber": "DE: DE89370400440532013000",
                "routingNumber": "DE: 370400440",
                "iban": "DE: DE89370400440532013000",
                "swiftCode": "DE: COBADEFFXXX",
                "accountDetails": {},
                "isActive": True,
                "isPrimary": False
            }
        ],
        "payGroupId": "<string>"
    }
]
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    {
      employeeData: {
        birthDate: '2023-12-25',
        employmentCountry: 'DE',
        externalRef: '<string>',
        startDate: '2023-12-25',
        endDate: '2023-12-25',
        birthPlace: '<string>',
        birthCountry: '<string>',
        personalEmail: 'jsmith@example.com',
        workEmail: 'jsmith@example.com',
        phoneNumbers: [{phoneNumber: '<string>', isPrimary: false}],
        personalData: {
          employeeName: {
            familyName: '<string>',
            givenName: '<string>',
            familyNamePrefix: '<string>',
            givenNameSuffix: '<string>',
            birthName: '<string>',
            birthFamilyNamePrefix: '<string>',
            birthGivenNameSuffix: '<string>',
            title: '<string>'
          },
          employmentCountry: 'DE',
          nationality: 'German',
          residenceAddress: 'Taigschuster 11, 82380 Peissenberg, Germany',
          validFrom: '2023-12-25',
          validTo: '2023-12-25'
        },
        relatedPersons: {
          persons: [
            {
              dependentName: {
                familyName: '<string>',
                givenName: '<string>',
                familyNamePrefix: '<string>',
                givenNameSuffix: '<string>',
                birthName: '<string>',
                birthFamilyNamePrefix: '<string>',
                birthGivenNameSuffix: '<string>',
                title: '<string>'
              },
              dependentBirthDate: '2023-12-25',
              relationshipProof: '<string>'
            }
          ],
          employmentCountry: 'DE',
          validFrom: '2023-12-25',
          validTo: '2023-12-25'
        },
        jobDetails: {
          employmentCountry: 'DE',
          isSeasonalWorker: false,
          jobTitle: '<string>',
          jobDescription: '<string>',
          occupationCode: '<string>',
          contractedWeeklyHours: 40,
          contractedWeekdays: [],
          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>',
          insuranceProvider: '<string>',
          alternateCollectionAgency: '<string>',
          privateInsuranceHealthMonthly: '0',
          privateInsuranceCareMonthly: '0',
          careInsuranceChildren: 0,
          u1Exempt: true,
          u2Exempt: true,
          uvRiskTariff: [{tariffCode: '<string>', tariffDescription: '<string>', tariffPercentage: '0'}],
          pensionDetails: {
            employmentCountry: 'DE',
            receivedMiningAdjustmentPayments: false,
            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: {
          taxId: '<string>',
          employmentCountry: 'DE',
          childAllowances: '0.0',
          factorProcedure: false,
          factor: 499,
          taxAllowanceAmount: 1,
          additionalTaxableAmount: 1,
          validFrom: '2023-12-25',
          validTo: '2023-12-25',
          churchMember: false
        }
      },
      bankAccounts: [
        {
          financialInstitutionName: '<string>',
          accountNumber: 'DE: DE89370400440532013000',
          routingNumber: 'DE: 370400440',
          iban: 'DE: DE89370400440532013000',
          swiftCode: 'DE: COBADEFFXXX',
          accountDetails: {},
          isActive: true,
          isPrimary: false
        }
      ],
      payGroupId: '<string>'
    }
  ])
};

fetch('https://preview.intermezzo.ai/organizations/{organization_id}/employees', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://preview.intermezzo.ai/organizations/{organization_id}/employees",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'employeeData' => [
                'birthDate' => '2023-12-25',
                'employmentCountry' => 'DE',
                'externalRef' => '<string>',
                'startDate' => '2023-12-25',
                'endDate' => '2023-12-25',
                'birthPlace' => '<string>',
                'birthCountry' => '<string>',
                'personalEmail' => 'jsmith@example.com',
                'workEmail' => 'jsmith@example.com',
                'phoneNumbers' => [
                                [
                                                                'phoneNumber' => '<string>',
                                                                'isPrimary' => false
                                ]
                ],
                'personalData' => [
                                'employeeName' => [
                                                                'familyName' => '<string>',
                                                                'givenName' => '<string>',
                                                                'familyNamePrefix' => '<string>',
                                                                'givenNameSuffix' => '<string>',
                                                                'birthName' => '<string>',
                                                                'birthFamilyNamePrefix' => '<string>',
                                                                'birthGivenNameSuffix' => '<string>',
                                                                'title' => '<string>'
                                ],
                                'employmentCountry' => 'DE',
                                'nationality' => 'German',
                                'residenceAddress' => 'Taigschuster 11, 82380 Peissenberg, Germany',
                                'validFrom' => '2023-12-25',
                                'validTo' => '2023-12-25'
                ],
                'relatedPersons' => [
                                'persons' => [
                                                                [
                                                                                                                                'dependentName' => [
                                                                                                                                                                                                                                                                'familyName' => '<string>',
                                                                                                                                                                                                                                                                'givenName' => '<string>',
                                                                                                                                                                                                                                                                'familyNamePrefix' => '<string>',
                                                                                                                                                                                                                                                                'givenNameSuffix' => '<string>',
                                                                                                                                                                                                                                                                'birthName' => '<string>',
                                                                                                                                                                                                                                                                'birthFamilyNamePrefix' => '<string>',
                                                                                                                                                                                                                                                                'birthGivenNameSuffix' => '<string>',
                                                                                                                                                                                                                                                                'title' => '<string>'
                                                                                                                                ],
                                                                                                                                'dependentBirthDate' => '2023-12-25',
                                                                                                                                'relationshipProof' => '<string>'
                                                                ]
                                ],
                                'employmentCountry' => 'DE',
                                'validFrom' => '2023-12-25',
                                'validTo' => '2023-12-25'
                ],
                'jobDetails' => [
                                'employmentCountry' => 'DE',
                                'isSeasonalWorker' => false,
                                'jobTitle' => '<string>',
                                'jobDescription' => '<string>',
                                'occupationCode' => '<string>',
                                'contractedWeeklyHours' => 40,
                                'contractedWeekdays' => [
                                                                
                                ],
                                '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>',
                                'insuranceProvider' => '<string>',
                                'alternateCollectionAgency' => '<string>',
                                'privateInsuranceHealthMonthly' => '0',
                                'privateInsuranceCareMonthly' => '0',
                                'careInsuranceChildren' => 0,
                                'u1Exempt' => true,
                                'u2Exempt' => true,
                                'uvRiskTariff' => [
                                                                [
                                                                                                                                'tariffCode' => '<string>',
                                                                                                                                'tariffDescription' => '<string>',
                                                                                                                                'tariffPercentage' => '0'
                                                                ]
                                ],
                                'pensionDetails' => [
                                                                'employmentCountry' => 'DE',
                                                                'receivedMiningAdjustmentPayments' => false,
                                                                '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' => [
                                'taxId' => '<string>',
                                'employmentCountry' => 'DE',
                                'childAllowances' => '0.0',
                                'factorProcedure' => false,
                                'factor' => 499,
                                'taxAllowanceAmount' => 1,
                                'additionalTaxableAmount' => 1,
                                'validFrom' => '2023-12-25',
                                'validTo' => '2023-12-25',
                                'churchMember' => false
                ]
        ],
        'bankAccounts' => [
                [
                                'financialInstitutionName' => '<string>',
                                'accountNumber' => 'DE: DE89370400440532013000',
                                'routingNumber' => 'DE: 370400440',
                                'iban' => 'DE: DE89370400440532013000',
                                'swiftCode' => 'DE: COBADEFFXXX',
                                'accountDetails' => [
                                                                
                                ],
                                'isActive' => true,
                                'isPrimary' => false
                ]
        ],
        'payGroupId' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://preview.intermezzo.ai/organizations/{organization_id}/employees"

	payload := strings.NewReader("[\n  {\n    \"employeeData\": {\n      \"birthDate\": \"2023-12-25\",\n      \"employmentCountry\": \"DE\",\n      \"externalRef\": \"<string>\",\n      \"startDate\": \"2023-12-25\",\n      \"endDate\": \"2023-12-25\",\n      \"birthPlace\": \"<string>\",\n      \"birthCountry\": \"<string>\",\n      \"personalEmail\": \"jsmith@example.com\",\n      \"workEmail\": \"jsmith@example.com\",\n      \"phoneNumbers\": [\n        {\n          \"phoneNumber\": \"<string>\",\n          \"isPrimary\": false\n        }\n      ],\n      \"personalData\": {\n        \"employeeName\": {\n          \"familyName\": \"<string>\",\n          \"givenName\": \"<string>\",\n          \"familyNamePrefix\": \"<string>\",\n          \"givenNameSuffix\": \"<string>\",\n          \"birthName\": \"<string>\",\n          \"birthFamilyNamePrefix\": \"<string>\",\n          \"birthGivenNameSuffix\": \"<string>\",\n          \"title\": \"<string>\"\n        },\n        \"employmentCountry\": \"DE\",\n        \"nationality\": \"German\",\n        \"residenceAddress\": \"Taigschuster 11, 82380 Peissenberg, Germany\",\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\"\n      },\n      \"relatedPersons\": {\n        \"persons\": [\n          {\n            \"dependentName\": {\n              \"familyName\": \"<string>\",\n              \"givenName\": \"<string>\",\n              \"familyNamePrefix\": \"<string>\",\n              \"givenNameSuffix\": \"<string>\",\n              \"birthName\": \"<string>\",\n              \"birthFamilyNamePrefix\": \"<string>\",\n              \"birthGivenNameSuffix\": \"<string>\",\n              \"title\": \"<string>\"\n            },\n            \"dependentBirthDate\": \"2023-12-25\",\n            \"relationshipProof\": \"<string>\"\n          }\n        ],\n        \"employmentCountry\": \"DE\",\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\"\n      },\n      \"jobDetails\": {\n        \"employmentCountry\": \"DE\",\n        \"isSeasonalWorker\": false,\n        \"jobTitle\": \"<string>\",\n        \"jobDescription\": \"<string>\",\n        \"occupationCode\": \"<string>\",\n        \"contractedWeeklyHours\": 40,\n        \"contractedWeekdays\": [],\n        \"contractedToOtherCompany\": false,\n        \"worksiteId\": \"<string>\",\n        \"department\": \"<string>\",\n        \"otherJobs\": [\n          {\n            \"employmentCountry\": \"DE\",\n            \"employerName\": \"<string>\",\n            \"employmentStartDate\": \"2023-12-25\",\n            \"monthlyGrossIncome\": 1\n          }\n        ],\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\"\n      },\n      \"insuranceDetails\": {\n        \"employmentCountry\": \"DE\",\n        \"insuranceNumber\": \"12345678A123\",\n        \"contributionGroup\": \"<string>\",\n        \"insuranceProvider\": \"<string>\",\n        \"alternateCollectionAgency\": \"<string>\",\n        \"privateInsuranceHealthMonthly\": \"0\",\n        \"privateInsuranceCareMonthly\": \"0\",\n        \"careInsuranceChildren\": 0,\n        \"u1Exempt\": true,\n        \"u2Exempt\": true,\n        \"uvRiskTariff\": [\n          {\n            \"tariffCode\": \"<string>\",\n            \"tariffDescription\": \"<string>\",\n            \"tariffPercentage\": \"0\"\n          }\n        ],\n        \"pensionDetails\": {\n          \"employmentCountry\": \"DE\",\n          \"receivedMiningAdjustmentPayments\": false,\n          \"pensionStartDate\": \"2023-12-25\",\n          \"waiverDeclarationStatus\": \"default\",\n          \"waiverReceiptDate\": \"2023-12-25\",\n          \"waiverValidityDate\": \"2023-12-25\"\n        },\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\",\n        \"birthDateContext\": \"2023-12-25\"\n      },\n      \"taxDetails\": {\n        \"taxId\": \"<string>\",\n        \"employmentCountry\": \"DE\",\n        \"childAllowances\": \"0.0\",\n        \"factorProcedure\": false,\n        \"factor\": 499,\n        \"taxAllowanceAmount\": 1,\n        \"additionalTaxableAmount\": 1,\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\",\n        \"churchMember\": false\n      }\n    },\n    \"bankAccounts\": [\n      {\n        \"financialInstitutionName\": \"<string>\",\n        \"accountNumber\": \"DE: DE89370400440532013000\",\n        \"routingNumber\": \"DE: 370400440\",\n        \"iban\": \"DE: DE89370400440532013000\",\n        \"swiftCode\": \"DE: COBADEFFXXX\",\n        \"accountDetails\": {},\n        \"isActive\": true,\n        \"isPrimary\": false\n      }\n    ],\n    \"payGroupId\": \"<string>\"\n  }\n]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://preview.intermezzo.ai/organizations/{organization_id}/employees")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"employeeData\": {\n      \"birthDate\": \"2023-12-25\",\n      \"employmentCountry\": \"DE\",\n      \"externalRef\": \"<string>\",\n      \"startDate\": \"2023-12-25\",\n      \"endDate\": \"2023-12-25\",\n      \"birthPlace\": \"<string>\",\n      \"birthCountry\": \"<string>\",\n      \"personalEmail\": \"jsmith@example.com\",\n      \"workEmail\": \"jsmith@example.com\",\n      \"phoneNumbers\": [\n        {\n          \"phoneNumber\": \"<string>\",\n          \"isPrimary\": false\n        }\n      ],\n      \"personalData\": {\n        \"employeeName\": {\n          \"familyName\": \"<string>\",\n          \"givenName\": \"<string>\",\n          \"familyNamePrefix\": \"<string>\",\n          \"givenNameSuffix\": \"<string>\",\n          \"birthName\": \"<string>\",\n          \"birthFamilyNamePrefix\": \"<string>\",\n          \"birthGivenNameSuffix\": \"<string>\",\n          \"title\": \"<string>\"\n        },\n        \"employmentCountry\": \"DE\",\n        \"nationality\": \"German\",\n        \"residenceAddress\": \"Taigschuster 11, 82380 Peissenberg, Germany\",\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\"\n      },\n      \"relatedPersons\": {\n        \"persons\": [\n          {\n            \"dependentName\": {\n              \"familyName\": \"<string>\",\n              \"givenName\": \"<string>\",\n              \"familyNamePrefix\": \"<string>\",\n              \"givenNameSuffix\": \"<string>\",\n              \"birthName\": \"<string>\",\n              \"birthFamilyNamePrefix\": \"<string>\",\n              \"birthGivenNameSuffix\": \"<string>\",\n              \"title\": \"<string>\"\n            },\n            \"dependentBirthDate\": \"2023-12-25\",\n            \"relationshipProof\": \"<string>\"\n          }\n        ],\n        \"employmentCountry\": \"DE\",\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\"\n      },\n      \"jobDetails\": {\n        \"employmentCountry\": \"DE\",\n        \"isSeasonalWorker\": false,\n        \"jobTitle\": \"<string>\",\n        \"jobDescription\": \"<string>\",\n        \"occupationCode\": \"<string>\",\n        \"contractedWeeklyHours\": 40,\n        \"contractedWeekdays\": [],\n        \"contractedToOtherCompany\": false,\n        \"worksiteId\": \"<string>\",\n        \"department\": \"<string>\",\n        \"otherJobs\": [\n          {\n            \"employmentCountry\": \"DE\",\n            \"employerName\": \"<string>\",\n            \"employmentStartDate\": \"2023-12-25\",\n            \"monthlyGrossIncome\": 1\n          }\n        ],\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\"\n      },\n      \"insuranceDetails\": {\n        \"employmentCountry\": \"DE\",\n        \"insuranceNumber\": \"12345678A123\",\n        \"contributionGroup\": \"<string>\",\n        \"insuranceProvider\": \"<string>\",\n        \"alternateCollectionAgency\": \"<string>\",\n        \"privateInsuranceHealthMonthly\": \"0\",\n        \"privateInsuranceCareMonthly\": \"0\",\n        \"careInsuranceChildren\": 0,\n        \"u1Exempt\": true,\n        \"u2Exempt\": true,\n        \"uvRiskTariff\": [\n          {\n            \"tariffCode\": \"<string>\",\n            \"tariffDescription\": \"<string>\",\n            \"tariffPercentage\": \"0\"\n          }\n        ],\n        \"pensionDetails\": {\n          \"employmentCountry\": \"DE\",\n          \"receivedMiningAdjustmentPayments\": false,\n          \"pensionStartDate\": \"2023-12-25\",\n          \"waiverDeclarationStatus\": \"default\",\n          \"waiverReceiptDate\": \"2023-12-25\",\n          \"waiverValidityDate\": \"2023-12-25\"\n        },\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\",\n        \"birthDateContext\": \"2023-12-25\"\n      },\n      \"taxDetails\": {\n        \"taxId\": \"<string>\",\n        \"employmentCountry\": \"DE\",\n        \"childAllowances\": \"0.0\",\n        \"factorProcedure\": false,\n        \"factor\": 499,\n        \"taxAllowanceAmount\": 1,\n        \"additionalTaxableAmount\": 1,\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\",\n        \"churchMember\": false\n      }\n    },\n    \"bankAccounts\": [\n      {\n        \"financialInstitutionName\": \"<string>\",\n        \"accountNumber\": \"DE: DE89370400440532013000\",\n        \"routingNumber\": \"DE: 370400440\",\n        \"iban\": \"DE: DE89370400440532013000\",\n        \"swiftCode\": \"DE: COBADEFFXXX\",\n        \"accountDetails\": {},\n        \"isActive\": true,\n        \"isPrimary\": false\n      }\n    ],\n    \"payGroupId\": \"<string>\"\n  }\n]")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://preview.intermezzo.ai/organizations/{organization_id}/employees")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"employeeData\": {\n      \"birthDate\": \"2023-12-25\",\n      \"employmentCountry\": \"DE\",\n      \"externalRef\": \"<string>\",\n      \"startDate\": \"2023-12-25\",\n      \"endDate\": \"2023-12-25\",\n      \"birthPlace\": \"<string>\",\n      \"birthCountry\": \"<string>\",\n      \"personalEmail\": \"jsmith@example.com\",\n      \"workEmail\": \"jsmith@example.com\",\n      \"phoneNumbers\": [\n        {\n          \"phoneNumber\": \"<string>\",\n          \"isPrimary\": false\n        }\n      ],\n      \"personalData\": {\n        \"employeeName\": {\n          \"familyName\": \"<string>\",\n          \"givenName\": \"<string>\",\n          \"familyNamePrefix\": \"<string>\",\n          \"givenNameSuffix\": \"<string>\",\n          \"birthName\": \"<string>\",\n          \"birthFamilyNamePrefix\": \"<string>\",\n          \"birthGivenNameSuffix\": \"<string>\",\n          \"title\": \"<string>\"\n        },\n        \"employmentCountry\": \"DE\",\n        \"nationality\": \"German\",\n        \"residenceAddress\": \"Taigschuster 11, 82380 Peissenberg, Germany\",\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\"\n      },\n      \"relatedPersons\": {\n        \"persons\": [\n          {\n            \"dependentName\": {\n              \"familyName\": \"<string>\",\n              \"givenName\": \"<string>\",\n              \"familyNamePrefix\": \"<string>\",\n              \"givenNameSuffix\": \"<string>\",\n              \"birthName\": \"<string>\",\n              \"birthFamilyNamePrefix\": \"<string>\",\n              \"birthGivenNameSuffix\": \"<string>\",\n              \"title\": \"<string>\"\n            },\n            \"dependentBirthDate\": \"2023-12-25\",\n            \"relationshipProof\": \"<string>\"\n          }\n        ],\n        \"employmentCountry\": \"DE\",\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\"\n      },\n      \"jobDetails\": {\n        \"employmentCountry\": \"DE\",\n        \"isSeasonalWorker\": false,\n        \"jobTitle\": \"<string>\",\n        \"jobDescription\": \"<string>\",\n        \"occupationCode\": \"<string>\",\n        \"contractedWeeklyHours\": 40,\n        \"contractedWeekdays\": [],\n        \"contractedToOtherCompany\": false,\n        \"worksiteId\": \"<string>\",\n        \"department\": \"<string>\",\n        \"otherJobs\": [\n          {\n            \"employmentCountry\": \"DE\",\n            \"employerName\": \"<string>\",\n            \"employmentStartDate\": \"2023-12-25\",\n            \"monthlyGrossIncome\": 1\n          }\n        ],\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\"\n      },\n      \"insuranceDetails\": {\n        \"employmentCountry\": \"DE\",\n        \"insuranceNumber\": \"12345678A123\",\n        \"contributionGroup\": \"<string>\",\n        \"insuranceProvider\": \"<string>\",\n        \"alternateCollectionAgency\": \"<string>\",\n        \"privateInsuranceHealthMonthly\": \"0\",\n        \"privateInsuranceCareMonthly\": \"0\",\n        \"careInsuranceChildren\": 0,\n        \"u1Exempt\": true,\n        \"u2Exempt\": true,\n        \"uvRiskTariff\": [\n          {\n            \"tariffCode\": \"<string>\",\n            \"tariffDescription\": \"<string>\",\n            \"tariffPercentage\": \"0\"\n          }\n        ],\n        \"pensionDetails\": {\n          \"employmentCountry\": \"DE\",\n          \"receivedMiningAdjustmentPayments\": false,\n          \"pensionStartDate\": \"2023-12-25\",\n          \"waiverDeclarationStatus\": \"default\",\n          \"waiverReceiptDate\": \"2023-12-25\",\n          \"waiverValidityDate\": \"2023-12-25\"\n        },\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\",\n        \"birthDateContext\": \"2023-12-25\"\n      },\n      \"taxDetails\": {\n        \"taxId\": \"<string>\",\n        \"employmentCountry\": \"DE\",\n        \"childAllowances\": \"0.0\",\n        \"factorProcedure\": false,\n        \"factor\": 499,\n        \"taxAllowanceAmount\": 1,\n        \"additionalTaxableAmount\": 1,\n        \"validFrom\": \"2023-12-25\",\n        \"validTo\": \"2023-12-25\",\n        \"churchMember\": false\n      }\n    },\n    \"bankAccounts\": [\n      {\n        \"financialInstitutionName\": \"<string>\",\n        \"accountNumber\": \"DE: DE89370400440532013000\",\n        \"routingNumber\": \"DE: 370400440\",\n        \"iban\": \"DE: DE89370400440532013000\",\n        \"swiftCode\": \"DE: COBADEFFXXX\",\n        \"accountDetails\": {},\n        \"isActive\": true,\n        \"isPrimary\": false\n      }\n    ],\n    \"payGroupId\": \"<string>\"\n  }\n]"

response = http.request(request)
puts response.read_body
[
  {
    "id": "<string>",
    "organizationId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "employeeData": {
      "birthDate": "2023-12-25",
      "personalData": {
        "employeeId": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "id": 123,
        "employeeName": {
          "familyName": "<string>",
          "givenName": "<string>",
          "familyNamePrefix": "<string>",
          "givenNameSuffix": "<string>",
          "birthName": "<string>",
          "birthFamilyNamePrefix": "<string>",
          "birthGivenNameSuffix": "<string>",
          "title": "<string>"
        },
        "employmentCountry": "DE",
        "nationality": "<string>",
        "residenceAddress": "<string>",
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25"
      },
      "relatedPersons": {
        "employeeId": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "id": 123,
        "persons": [
          {}
        ],
        "employmentCountry": "DE",
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25"
      },
      "jobDetails": {
        "employeeId": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "id": "<string>",
        "employmentCountry": "DE",
        "isSeasonalWorker": true,
        "jobTitle": "<string>",
        "jobDescription": "<string>",
        "occupationCode": "<string>",
        "contractedWeeklyHours": 40,
        "contractedWeekdays": [],
        "contractedToOtherCompany": false,
        "worksiteId": "<string>",
        "department": "<string>",
        "otherJobs": [
          {
            "employmentCountry": "DE",
            "employerName": "<string>",
            "employmentStartDate": "2023-12-25",
            "monthlyGrossIncome": "<string>"
          }
        ],
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25"
      },
      "insuranceDetails": {
        "employeeId": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "id": "<string>",
        "employmentCountry": "DE",
        "insuranceNumber": "<string>",
        "contributionGroup": "<string>",
        "insuranceProvider": "<string>",
        "alternateCollectionAgency": "<string>",
        "privateInsuranceHealthMonthly": "0",
        "privateInsuranceCareMonthly": "0",
        "careInsuranceChildren": 0,
        "u1Exempt": false,
        "u2Exempt": false,
        "uvRiskTariff": [
          {
            "tariffCode": "<string>",
            "tariffDescription": "<string>",
            "tariffPercentage": "0"
          }
        ],
        "pensionDetails": {
          "employmentCountry": "DE",
          "receivedMiningAdjustmentPayments": false,
          "pensionStartDate": "2023-12-25",
          "waiverDeclarationStatus": "default",
          "waiverReceiptDate": "2023-12-25",
          "waiverValidityDate": "2023-12-25"
        },
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25"
      },
      "taxDetails": {
        "employeeId": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "id": "<string>",
        "taxId": "<string>",
        "employmentCountry": "DE",
        "childAllowances": "0.0",
        "factorProcedure": false,
        "factor": 123,
        "taxAllowanceAmount": "0.00",
        "additionalTaxableAmount": "0.00",
        "validFrom": "2023-12-25",
        "validTo": "2023-12-25",
        "churchMember": false
      },
      "employmentCountry": "DE",
      "externalRef": "<string>",
      "startDate": "2023-12-25",
      "endDate": "2023-12-25",
      "birthPlace": "<string>",
      "birthCountry": "<string>",
      "personalEmail": "jsmith@example.com",
      "workEmail": "jsmith@example.com",
      "phoneNumbers": [
        {
          "phoneNumber": "<string>",
          "isPrimary": false
        }
      ],
      "previousEmployeeId": "<string>",
      "nextEmployeeId": "<string>"
    },
    "bankAccounts": [
      {
        "financialInstitutionName": "<string>",
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "accountNumber": "DE: DE89370400440532013000",
        "routingNumber": "DE: 370400440",
        "iban": "DE: DE89370400440532013000",
        "swiftCode": "DE: COBADEFFXXX",
        "accountDetails": {},
        "isActive": true,
        "isPrimary": false
      }
    ],
    "payGroupId": "<string>"
  }
]
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Get token from Auth0 and paste it here

Path Parameters

organization_id
required

Body

application/json
employeeData
DEEmployee · object
required

Schema for German employee data.

bankAccounts
BankAccountRequest · object[] | null

List of bank accounts associated with the employee

payGroupId

Pay group ID for the employee

Response

Successful Response

id
string
required

Unique employee identifier

organizationId
string
required

Employee's organization

createdAt
string<date-time> | null
required

Employee record creation timestamp

updatedAt
string<date-time> | null
required

Employee record last update timestamp

employeeData
DEEmployeeResponse · object
required

Country-specific employee data with IDs and timestamps

bankAccounts
BankAccountResponse · object[]
required

Employee bank accounts

payGroupId
string | null

Pay group ID for the employee