POST
/
organizations
/
{organization_id}
/
employees
Create Employees
curl --request POST \
  --url https://dev.intermezzo.ai/organizations/{organization_id}/employees \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "employee_data": {
      "birth_date": "2023-12-25",
      "employment_country": "DE",
      "external_ref": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25",
      "birth_place": "<string>",
      "birth_country": "<string>",
      "personal_email": "jsmith@example.com",
      "work_email": "jsmith@example.com",
      "phone_numbers": [
        {
          "phone_number": "<string>",
          "is_primary": false
        }
      ],
      "personal_data": {
        "employee_name": {
          "family_name": "<string>",
          "given_name": "<string>",
          "family_name_prefix": "<string>",
          "given_name_suffix": "<string>",
          "birth_name": "<string>",
          "birth_family_name_prefix": "<string>",
          "birth_given_name_suffix": "<string>",
          "title": "<string>"
        },
        "employment_country": "DE",
        "nationality": "German",
        "residence_address": "Taigschuster 11, 82380 Peissenberg, Germany",
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25"
      },
      "related_persons": {
        "persons": [
          {
            "dependent_name": {
              "family_name": "<string>",
              "given_name": "<string>",
              "family_name_prefix": "<string>",
              "given_name_suffix": "<string>",
              "birth_name": "<string>",
              "birth_family_name_prefix": "<string>",
              "birth_given_name_suffix": "<string>",
              "title": "<string>"
            },
            "dependent_birth_date": "2023-12-25",
            "relationship_proof": "<string>"
          }
        ],
        "employment_country": "DE",
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25"
      },
      "job_details": {
        "employment_country": "DE",
        "is_seasonal_worker": false,
        "job_title": "<string>",
        "job_description": "<string>",
        "occupation_code": "<string>",
        "contracted_weekly_hours": 40,
        "contracted_weekdays": [],
        "contracted_to_other_company": false,
        "worksite_id": "<string>",
        "department": "<string>",
        "other_jobs": [
          {
            "employment_country": "DE",
            "employer_name": "<string>",
            "employment_start_date": "2023-12-25",
            "monthly_gross_income": 1
          }
        ],
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25"
      },
      "insurance_details": {
        "employment_country": "DE",
        "insurance_number": "12345678A123",
        "contribution_group": "<string>",
        "insurance_provider": "<string>",
        "alternate_collection_agency": "<string>",
        "private_insurance_health_monthly": "0",
        "private_insurance_care_monthly": "0",
        "care_insurance_children": 0,
        "u1_exempt": true,
        "u2_exempt": true,
        "uv_risk_tariff": [
          {
            "tariff_code": "<string>",
            "tariff_description": "<string>",
            "tariff_percentage": "0"
          }
        ],
        "pension_details": {
          "employment_country": "DE",
          "received_mining_adjustment_payments": false,
          "pension_start_date": "2023-12-25",
          "waiver_declaration_status": "default",
          "waiver_receipt_date": "2023-12-25",
          "waiver_validity_date": "2023-12-25"
        },
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25",
        "birth_date_context": "2023-12-25"
      },
      "tax_details": {
        "tax_id": "<string>",
        "employment_country": "DE",
        "child_allowances": "0.0",
        "factor_procedure": false,
        "factor": 499,
        "tax_allowance_amount": 1,
        "additional_taxable_amount": 1,
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25",
        "church_member": false
      }
    },
    "bank_accounts": [
      {
        "financial_institution_name": "<string>",
        "account_number": "DE: DE89370400440532013000",
        "routing_number": "DE: 370400440",
        "iban": "DE: DE89370400440532013000",
        "swift_code": "DE: COBADEFFXXX",
        "account_details": {},
        "is_active": true,
        "is_primary": false
      }
    ],
    "pay_group_id": "<string>"
  }
]
'
import requests

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

payload = [
{
"employee_data": {
"birth_date": "2023-12-25",
"employment_country": "DE",
"external_ref": "<string>",
"start_date": "2023-12-25",
"end_date": "2023-12-25",
"birth_place": "<string>",
"birth_country": "<string>",
"personal_email": "jsmith@example.com",
"work_email": "jsmith@example.com",
"phone_numbers": [
{
"phone_number": "<string>",
"is_primary": False
}
],
"personal_data": {
"employee_name": {
"family_name": "<string>",
"given_name": "<string>",
"family_name_prefix": "<string>",
"given_name_suffix": "<string>",
"birth_name": "<string>",
"birth_family_name_prefix": "<string>",
"birth_given_name_suffix": "<string>",
"title": "<string>"
},
"employment_country": "DE",
"nationality": "German",
"residence_address": "Taigschuster 11, 82380 Peissenberg, Germany",
"valid_from": "2023-12-25",
"valid_to": "2023-12-25"
},
"related_persons": {
"persons": [
{
"dependent_name": {
"family_name": "<string>",
"given_name": "<string>",
"family_name_prefix": "<string>",
"given_name_suffix": "<string>",
"birth_name": "<string>",
"birth_family_name_prefix": "<string>",
"birth_given_name_suffix": "<string>",
"title": "<string>"
},
"dependent_birth_date": "2023-12-25",
"relationship_proof": "<string>"
}
],
"employment_country": "DE",
"valid_from": "2023-12-25",
"valid_to": "2023-12-25"
},
"job_details": {
"employment_country": "DE",
"is_seasonal_worker": False,
"job_title": "<string>",
"job_description": "<string>",
"occupation_code": "<string>",
"contracted_weekly_hours": 40,
"contracted_weekdays": [],
"contracted_to_other_company": False,
"worksite_id": "<string>",
"department": "<string>",
"other_jobs": [
{
"employment_country": "DE",
"employer_name": "<string>",
"employment_start_date": "2023-12-25",
"monthly_gross_income": 1
}
],
"valid_from": "2023-12-25",
"valid_to": "2023-12-25"
},
"insurance_details": {
"employment_country": "DE",
"insurance_number": "12345678A123",
"contribution_group": "<string>",
"insurance_provider": "<string>",
"alternate_collection_agency": "<string>",
"private_insurance_health_monthly": "0",
"private_insurance_care_monthly": "0",
"care_insurance_children": 0,
"u1_exempt": True,
"u2_exempt": True,
"uv_risk_tariff": [
{
"tariff_code": "<string>",
"tariff_description": "<string>",
"tariff_percentage": "0"
}
],
"pension_details": {
"employment_country": "DE",
"received_mining_adjustment_payments": False,
"pension_start_date": "2023-12-25",
"waiver_declaration_status": "default",
"waiver_receipt_date": "2023-12-25",
"waiver_validity_date": "2023-12-25"
},
"valid_from": "2023-12-25",
"valid_to": "2023-12-25",
"birth_date_context": "2023-12-25"
},
"tax_details": {
"tax_id": "<string>",
"employment_country": "DE",
"child_allowances": "0.0",
"factor_procedure": False,
"factor": 499,
"tax_allowance_amount": 1,
"additional_taxable_amount": 1,
"valid_from": "2023-12-25",
"valid_to": "2023-12-25",
"church_member": False
}
},
"bank_accounts": [
{
"financial_institution_name": "<string>",
"account_number": "DE: DE89370400440532013000",
"routing_number": "DE: 370400440",
"iban": "DE: DE89370400440532013000",
"swift_code": "DE: COBADEFFXXX",
"account_details": {},
"is_active": True,
"is_primary": False
}
],
"pay_group_id": "<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([
{
employee_data: {
birth_date: '2023-12-25',
employment_country: 'DE',
external_ref: '<string>',
start_date: '2023-12-25',
end_date: '2023-12-25',
birth_place: '<string>',
birth_country: '<string>',
personal_email: 'jsmith@example.com',
work_email: 'jsmith@example.com',
phone_numbers: [{phone_number: '<string>', is_primary: false}],
personal_data: {
employee_name: {
family_name: '<string>',
given_name: '<string>',
family_name_prefix: '<string>',
given_name_suffix: '<string>',
birth_name: '<string>',
birth_family_name_prefix: '<string>',
birth_given_name_suffix: '<string>',
title: '<string>'
},
employment_country: 'DE',
nationality: 'German',
residence_address: 'Taigschuster 11, 82380 Peissenberg, Germany',
valid_from: '2023-12-25',
valid_to: '2023-12-25'
},
related_persons: {
persons: [
{
dependent_name: {
family_name: '<string>',
given_name: '<string>',
family_name_prefix: '<string>',
given_name_suffix: '<string>',
birth_name: '<string>',
birth_family_name_prefix: '<string>',
birth_given_name_suffix: '<string>',
title: '<string>'
},
dependent_birth_date: '2023-12-25',
relationship_proof: '<string>'
}
],
employment_country: 'DE',
valid_from: '2023-12-25',
valid_to: '2023-12-25'
},
job_details: {
employment_country: 'DE',
is_seasonal_worker: false,
job_title: '<string>',
job_description: '<string>',
occupation_code: '<string>',
contracted_weekly_hours: 40,
contracted_weekdays: [],
contracted_to_other_company: false,
worksite_id: '<string>',
department: '<string>',
other_jobs: [
{
employment_country: 'DE',
employer_name: '<string>',
employment_start_date: '2023-12-25',
monthly_gross_income: 1
}
],
valid_from: '2023-12-25',
valid_to: '2023-12-25'
},
insurance_details: {
employment_country: 'DE',
insurance_number: '12345678A123',
contribution_group: '<string>',
insurance_provider: '<string>',
alternate_collection_agency: '<string>',
private_insurance_health_monthly: '0',
private_insurance_care_monthly: '0',
care_insurance_children: 0,
u1_exempt: true,
u2_exempt: true,
uv_risk_tariff: [
{
tariff_code: '<string>',
tariff_description: '<string>',
tariff_percentage: '0'
}
],
pension_details: {
employment_country: 'DE',
received_mining_adjustment_payments: false,
pension_start_date: '2023-12-25',
waiver_declaration_status: 'default',
waiver_receipt_date: '2023-12-25',
waiver_validity_date: '2023-12-25'
},
valid_from: '2023-12-25',
valid_to: '2023-12-25',
birth_date_context: '2023-12-25'
},
tax_details: {
tax_id: '<string>',
employment_country: 'DE',
child_allowances: '0.0',
factor_procedure: false,
factor: 499,
tax_allowance_amount: 1,
additional_taxable_amount: 1,
valid_from: '2023-12-25',
valid_to: '2023-12-25',
church_member: false
}
},
bank_accounts: [
{
financial_institution_name: '<string>',
account_number: 'DE: DE89370400440532013000',
routing_number: 'DE: 370400440',
iban: 'DE: DE89370400440532013000',
swift_code: 'DE: COBADEFFXXX',
account_details: {},
is_active: true,
is_primary: false
}
],
pay_group_id: '<string>'
}
])
};

fetch('https://dev.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://dev.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([
[
'employee_data' => [
'birth_date' => '2023-12-25',
'employment_country' => 'DE',
'external_ref' => '<string>',
'start_date' => '2023-12-25',
'end_date' => '2023-12-25',
'birth_place' => '<string>',
'birth_country' => '<string>',
'personal_email' => 'jsmith@example.com',
'work_email' => 'jsmith@example.com',
'phone_numbers' => [
[
'phone_number' => '<string>',
'is_primary' => false
]
],
'personal_data' => [
'employee_name' => [
'family_name' => '<string>',
'given_name' => '<string>',
'family_name_prefix' => '<string>',
'given_name_suffix' => '<string>',
'birth_name' => '<string>',
'birth_family_name_prefix' => '<string>',
'birth_given_name_suffix' => '<string>',
'title' => '<string>'
],
'employment_country' => 'DE',
'nationality' => 'German',
'residence_address' => 'Taigschuster 11, 82380 Peissenberg, Germany',
'valid_from' => '2023-12-25',
'valid_to' => '2023-12-25'
],
'related_persons' => [
'persons' => [
[
'dependent_name' => [
'family_name' => '<string>',
'given_name' => '<string>',
'family_name_prefix' => '<string>',
'given_name_suffix' => '<string>',
'birth_name' => '<string>',
'birth_family_name_prefix' => '<string>',
'birth_given_name_suffix' => '<string>',
'title' => '<string>'
],
'dependent_birth_date' => '2023-12-25',
'relationship_proof' => '<string>'
]
],
'employment_country' => 'DE',
'valid_from' => '2023-12-25',
'valid_to' => '2023-12-25'
],
'job_details' => [
'employment_country' => 'DE',
'is_seasonal_worker' => false,
'job_title' => '<string>',
'job_description' => '<string>',
'occupation_code' => '<string>',
'contracted_weekly_hours' => 40,
'contracted_weekdays' => [

],
'contracted_to_other_company' => false,
'worksite_id' => '<string>',
'department' => '<string>',
'other_jobs' => [
[
'employment_country' => 'DE',
'employer_name' => '<string>',
'employment_start_date' => '2023-12-25',
'monthly_gross_income' => 1
]
],
'valid_from' => '2023-12-25',
'valid_to' => '2023-12-25'
],
'insurance_details' => [
'employment_country' => 'DE',
'insurance_number' => '12345678A123',
'contribution_group' => '<string>',
'insurance_provider' => '<string>',
'alternate_collection_agency' => '<string>',
'private_insurance_health_monthly' => '0',
'private_insurance_care_monthly' => '0',
'care_insurance_children' => 0,
'u1_exempt' => true,
'u2_exempt' => true,
'uv_risk_tariff' => [
[
'tariff_code' => '<string>',
'tariff_description' => '<string>',
'tariff_percentage' => '0'
]
],
'pension_details' => [
'employment_country' => 'DE',
'received_mining_adjustment_payments' => false,
'pension_start_date' => '2023-12-25',
'waiver_declaration_status' => 'default',
'waiver_receipt_date' => '2023-12-25',
'waiver_validity_date' => '2023-12-25'
],
'valid_from' => '2023-12-25',
'valid_to' => '2023-12-25',
'birth_date_context' => '2023-12-25'
],
'tax_details' => [
'tax_id' => '<string>',
'employment_country' => 'DE',
'child_allowances' => '0.0',
'factor_procedure' => false,
'factor' => 499,
'tax_allowance_amount' => 1,
'additional_taxable_amount' => 1,
'valid_from' => '2023-12-25',
'valid_to' => '2023-12-25',
'church_member' => false
]
],
'bank_accounts' => [
[
'financial_institution_name' => '<string>',
'account_number' => 'DE: DE89370400440532013000',
'routing_number' => 'DE: 370400440',
'iban' => 'DE: DE89370400440532013000',
'swift_code' => 'DE: COBADEFFXXX',
'account_details' => [

],
'is_active' => true,
'is_primary' => false
]
],
'pay_group_id' => '<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://dev.intermezzo.ai/organizations/{organization_id}/employees"

payload := strings.NewReader("[\n {\n \"employee_data\": {\n \"birth_date\": \"2023-12-25\",\n \"employment_country\": \"DE\",\n \"external_ref\": \"<string>\",\n \"start_date\": \"2023-12-25\",\n \"end_date\": \"2023-12-25\",\n \"birth_place\": \"<string>\",\n \"birth_country\": \"<string>\",\n \"personal_email\": \"jsmith@example.com\",\n \"work_email\": \"jsmith@example.com\",\n \"phone_numbers\": [\n {\n \"phone_number\": \"<string>\",\n \"is_primary\": false\n }\n ],\n \"personal_data\": {\n \"employee_name\": {\n \"family_name\": \"<string>\",\n \"given_name\": \"<string>\",\n \"family_name_prefix\": \"<string>\",\n \"given_name_suffix\": \"<string>\",\n \"birth_name\": \"<string>\",\n \"birth_family_name_prefix\": \"<string>\",\n \"birth_given_name_suffix\": \"<string>\",\n \"title\": \"<string>\"\n },\n \"employment_country\": \"DE\",\n \"nationality\": \"German\",\n \"residence_address\": \"Taigschuster 11, 82380 Peissenberg, Germany\",\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\"\n },\n \"related_persons\": {\n \"persons\": [\n {\n \"dependent_name\": {\n \"family_name\": \"<string>\",\n \"given_name\": \"<string>\",\n \"family_name_prefix\": \"<string>\",\n \"given_name_suffix\": \"<string>\",\n \"birth_name\": \"<string>\",\n \"birth_family_name_prefix\": \"<string>\",\n \"birth_given_name_suffix\": \"<string>\",\n \"title\": \"<string>\"\n },\n \"dependent_birth_date\": \"2023-12-25\",\n \"relationship_proof\": \"<string>\"\n }\n ],\n \"employment_country\": \"DE\",\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\"\n },\n \"job_details\": {\n \"employment_country\": \"DE\",\n \"is_seasonal_worker\": false,\n \"job_title\": \"<string>\",\n \"job_description\": \"<string>\",\n \"occupation_code\": \"<string>\",\n \"contracted_weekly_hours\": 40,\n \"contracted_weekdays\": [],\n \"contracted_to_other_company\": false,\n \"worksite_id\": \"<string>\",\n \"department\": \"<string>\",\n \"other_jobs\": [\n {\n \"employment_country\": \"DE\",\n \"employer_name\": \"<string>\",\n \"employment_start_date\": \"2023-12-25\",\n \"monthly_gross_income\": 1\n }\n ],\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\"\n },\n \"insurance_details\": {\n \"employment_country\": \"DE\",\n \"insurance_number\": \"12345678A123\",\n \"contribution_group\": \"<string>\",\n \"insurance_provider\": \"<string>\",\n \"alternate_collection_agency\": \"<string>\",\n \"private_insurance_health_monthly\": \"0\",\n \"private_insurance_care_monthly\": \"0\",\n \"care_insurance_children\": 0,\n \"u1_exempt\": true,\n \"u2_exempt\": true,\n \"uv_risk_tariff\": [\n {\n \"tariff_code\": \"<string>\",\n \"tariff_description\": \"<string>\",\n \"tariff_percentage\": \"0\"\n }\n ],\n \"pension_details\": {\n \"employment_country\": \"DE\",\n \"received_mining_adjustment_payments\": false,\n \"pension_start_date\": \"2023-12-25\",\n \"waiver_declaration_status\": \"default\",\n \"waiver_receipt_date\": \"2023-12-25\",\n \"waiver_validity_date\": \"2023-12-25\"\n },\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\",\n \"birth_date_context\": \"2023-12-25\"\n },\n \"tax_details\": {\n \"tax_id\": \"<string>\",\n \"employment_country\": \"DE\",\n \"child_allowances\": \"0.0\",\n \"factor_procedure\": false,\n \"factor\": 499,\n \"tax_allowance_amount\": 1,\n \"additional_taxable_amount\": 1,\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\",\n \"church_member\": false\n }\n },\n \"bank_accounts\": [\n {\n \"financial_institution_name\": \"<string>\",\n \"account_number\": \"DE: DE89370400440532013000\",\n \"routing_number\": \"DE: 370400440\",\n \"iban\": \"DE: DE89370400440532013000\",\n \"swift_code\": \"DE: COBADEFFXXX\",\n \"account_details\": {},\n \"is_active\": true,\n \"is_primary\": false\n }\n ],\n \"pay_group_id\": \"<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://dev.intermezzo.ai/organizations/{organization_id}/employees")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"employee_data\": {\n \"birth_date\": \"2023-12-25\",\n \"employment_country\": \"DE\",\n \"external_ref\": \"<string>\",\n \"start_date\": \"2023-12-25\",\n \"end_date\": \"2023-12-25\",\n \"birth_place\": \"<string>\",\n \"birth_country\": \"<string>\",\n \"personal_email\": \"jsmith@example.com\",\n \"work_email\": \"jsmith@example.com\",\n \"phone_numbers\": [\n {\n \"phone_number\": \"<string>\",\n \"is_primary\": false\n }\n ],\n \"personal_data\": {\n \"employee_name\": {\n \"family_name\": \"<string>\",\n \"given_name\": \"<string>\",\n \"family_name_prefix\": \"<string>\",\n \"given_name_suffix\": \"<string>\",\n \"birth_name\": \"<string>\",\n \"birth_family_name_prefix\": \"<string>\",\n \"birth_given_name_suffix\": \"<string>\",\n \"title\": \"<string>\"\n },\n \"employment_country\": \"DE\",\n \"nationality\": \"German\",\n \"residence_address\": \"Taigschuster 11, 82380 Peissenberg, Germany\",\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\"\n },\n \"related_persons\": {\n \"persons\": [\n {\n \"dependent_name\": {\n \"family_name\": \"<string>\",\n \"given_name\": \"<string>\",\n \"family_name_prefix\": \"<string>\",\n \"given_name_suffix\": \"<string>\",\n \"birth_name\": \"<string>\",\n \"birth_family_name_prefix\": \"<string>\",\n \"birth_given_name_suffix\": \"<string>\",\n \"title\": \"<string>\"\n },\n \"dependent_birth_date\": \"2023-12-25\",\n \"relationship_proof\": \"<string>\"\n }\n ],\n \"employment_country\": \"DE\",\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\"\n },\n \"job_details\": {\n \"employment_country\": \"DE\",\n \"is_seasonal_worker\": false,\n \"job_title\": \"<string>\",\n \"job_description\": \"<string>\",\n \"occupation_code\": \"<string>\",\n \"contracted_weekly_hours\": 40,\n \"contracted_weekdays\": [],\n \"contracted_to_other_company\": false,\n \"worksite_id\": \"<string>\",\n \"department\": \"<string>\",\n \"other_jobs\": [\n {\n \"employment_country\": \"DE\",\n \"employer_name\": \"<string>\",\n \"employment_start_date\": \"2023-12-25\",\n \"monthly_gross_income\": 1\n }\n ],\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\"\n },\n \"insurance_details\": {\n \"employment_country\": \"DE\",\n \"insurance_number\": \"12345678A123\",\n \"contribution_group\": \"<string>\",\n \"insurance_provider\": \"<string>\",\n \"alternate_collection_agency\": \"<string>\",\n \"private_insurance_health_monthly\": \"0\",\n \"private_insurance_care_monthly\": \"0\",\n \"care_insurance_children\": 0,\n \"u1_exempt\": true,\n \"u2_exempt\": true,\n \"uv_risk_tariff\": [\n {\n \"tariff_code\": \"<string>\",\n \"tariff_description\": \"<string>\",\n \"tariff_percentage\": \"0\"\n }\n ],\n \"pension_details\": {\n \"employment_country\": \"DE\",\n \"received_mining_adjustment_payments\": false,\n \"pension_start_date\": \"2023-12-25\",\n \"waiver_declaration_status\": \"default\",\n \"waiver_receipt_date\": \"2023-12-25\",\n \"waiver_validity_date\": \"2023-12-25\"\n },\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\",\n \"birth_date_context\": \"2023-12-25\"\n },\n \"tax_details\": {\n \"tax_id\": \"<string>\",\n \"employment_country\": \"DE\",\n \"child_allowances\": \"0.0\",\n \"factor_procedure\": false,\n \"factor\": 499,\n \"tax_allowance_amount\": 1,\n \"additional_taxable_amount\": 1,\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\",\n \"church_member\": false\n }\n },\n \"bank_accounts\": [\n {\n \"financial_institution_name\": \"<string>\",\n \"account_number\": \"DE: DE89370400440532013000\",\n \"routing_number\": \"DE: 370400440\",\n \"iban\": \"DE: DE89370400440532013000\",\n \"swift_code\": \"DE: COBADEFFXXX\",\n \"account_details\": {},\n \"is_active\": true,\n \"is_primary\": false\n }\n ],\n \"pay_group_id\": \"<string>\"\n }\n]")
.asString();
require 'uri'
require 'net/http'

url = URI("https://dev.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 \"employee_data\": {\n \"birth_date\": \"2023-12-25\",\n \"employment_country\": \"DE\",\n \"external_ref\": \"<string>\",\n \"start_date\": \"2023-12-25\",\n \"end_date\": \"2023-12-25\",\n \"birth_place\": \"<string>\",\n \"birth_country\": \"<string>\",\n \"personal_email\": \"jsmith@example.com\",\n \"work_email\": \"jsmith@example.com\",\n \"phone_numbers\": [\n {\n \"phone_number\": \"<string>\",\n \"is_primary\": false\n }\n ],\n \"personal_data\": {\n \"employee_name\": {\n \"family_name\": \"<string>\",\n \"given_name\": \"<string>\",\n \"family_name_prefix\": \"<string>\",\n \"given_name_suffix\": \"<string>\",\n \"birth_name\": \"<string>\",\n \"birth_family_name_prefix\": \"<string>\",\n \"birth_given_name_suffix\": \"<string>\",\n \"title\": \"<string>\"\n },\n \"employment_country\": \"DE\",\n \"nationality\": \"German\",\n \"residence_address\": \"Taigschuster 11, 82380 Peissenberg, Germany\",\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\"\n },\n \"related_persons\": {\n \"persons\": [\n {\n \"dependent_name\": {\n \"family_name\": \"<string>\",\n \"given_name\": \"<string>\",\n \"family_name_prefix\": \"<string>\",\n \"given_name_suffix\": \"<string>\",\n \"birth_name\": \"<string>\",\n \"birth_family_name_prefix\": \"<string>\",\n \"birth_given_name_suffix\": \"<string>\",\n \"title\": \"<string>\"\n },\n \"dependent_birth_date\": \"2023-12-25\",\n \"relationship_proof\": \"<string>\"\n }\n ],\n \"employment_country\": \"DE\",\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\"\n },\n \"job_details\": {\n \"employment_country\": \"DE\",\n \"is_seasonal_worker\": false,\n \"job_title\": \"<string>\",\n \"job_description\": \"<string>\",\n \"occupation_code\": \"<string>\",\n \"contracted_weekly_hours\": 40,\n \"contracted_weekdays\": [],\n \"contracted_to_other_company\": false,\n \"worksite_id\": \"<string>\",\n \"department\": \"<string>\",\n \"other_jobs\": [\n {\n \"employment_country\": \"DE\",\n \"employer_name\": \"<string>\",\n \"employment_start_date\": \"2023-12-25\",\n \"monthly_gross_income\": 1\n }\n ],\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\"\n },\n \"insurance_details\": {\n \"employment_country\": \"DE\",\n \"insurance_number\": \"12345678A123\",\n \"contribution_group\": \"<string>\",\n \"insurance_provider\": \"<string>\",\n \"alternate_collection_agency\": \"<string>\",\n \"private_insurance_health_monthly\": \"0\",\n \"private_insurance_care_monthly\": \"0\",\n \"care_insurance_children\": 0,\n \"u1_exempt\": true,\n \"u2_exempt\": true,\n \"uv_risk_tariff\": [\n {\n \"tariff_code\": \"<string>\",\n \"tariff_description\": \"<string>\",\n \"tariff_percentage\": \"0\"\n }\n ],\n \"pension_details\": {\n \"employment_country\": \"DE\",\n \"received_mining_adjustment_payments\": false,\n \"pension_start_date\": \"2023-12-25\",\n \"waiver_declaration_status\": \"default\",\n \"waiver_receipt_date\": \"2023-12-25\",\n \"waiver_validity_date\": \"2023-12-25\"\n },\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\",\n \"birth_date_context\": \"2023-12-25\"\n },\n \"tax_details\": {\n \"tax_id\": \"<string>\",\n \"employment_country\": \"DE\",\n \"child_allowances\": \"0.0\",\n \"factor_procedure\": false,\n \"factor\": 499,\n \"tax_allowance_amount\": 1,\n \"additional_taxable_amount\": 1,\n \"valid_from\": \"2023-12-25\",\n \"valid_to\": \"2023-12-25\",\n \"church_member\": false\n }\n },\n \"bank_accounts\": [\n {\n \"financial_institution_name\": \"<string>\",\n \"account_number\": \"DE: DE89370400440532013000\",\n \"routing_number\": \"DE: 370400440\",\n \"iban\": \"DE: DE89370400440532013000\",\n \"swift_code\": \"DE: COBADEFFXXX\",\n \"account_details\": {},\n \"is_active\": true,\n \"is_primary\": false\n }\n ],\n \"pay_group_id\": \"<string>\"\n }\n]"

response = http.request(request)
puts response.read_body
[
  {
    "id": "<string>",
    "organization_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "employee_data": {
      "birth_date": "2023-12-25",
      "personal_data": {
        "employee_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "id": 123,
        "employee_name": {
          "family_name": "<string>",
          "given_name": "<string>",
          "family_name_prefix": "<string>",
          "given_name_suffix": "<string>",
          "birth_name": "<string>",
          "birth_family_name_prefix": "<string>",
          "birth_given_name_suffix": "<string>",
          "title": "<string>"
        },
        "employment_country": "DE",
        "nationality": "<string>",
        "residence_address": "<string>",
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25"
      },
      "related_persons": {
        "employee_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "id": 123,
        "persons": [
          {}
        ],
        "employment_country": "DE",
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25"
      },
      "job_details": {
        "employee_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "id": "<string>",
        "employment_country": "DE",
        "is_seasonal_worker": true,
        "job_title": "<string>",
        "job_description": "<string>",
        "occupation_code": "<string>",
        "contracted_weekly_hours": 40,
        "contracted_weekdays": [],
        "contracted_to_other_company": false,
        "worksite_id": "<string>",
        "department": "<string>",
        "other_jobs": [
          {
            "employment_country": "DE",
            "employer_name": "<string>",
            "employment_start_date": "2023-12-25",
            "monthly_gross_income": "<string>"
          }
        ],
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25"
      },
      "insurance_details": {
        "employee_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "id": "<string>",
        "employment_country": "DE",
        "insurance_number": "<string>",
        "contribution_group": "<string>",
        "insurance_provider": "<string>",
        "alternate_collection_agency": "<string>",
        "private_insurance_health_monthly": "0",
        "private_insurance_care_monthly": "0",
        "care_insurance_children": 0,
        "u1_exempt": false,
        "u2_exempt": false,
        "uv_risk_tariff": [
          {
            "tariff_code": "<string>",
            "tariff_description": "<string>",
            "tariff_percentage": "0"
          }
        ],
        "pension_details": {
          "employment_country": "DE",
          "received_mining_adjustment_payments": false,
          "pension_start_date": "2023-12-25",
          "waiver_declaration_status": "default",
          "waiver_receipt_date": "2023-12-25",
          "waiver_validity_date": "2023-12-25"
        },
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25"
      },
      "tax_details": {
        "employee_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "id": "<string>",
        "tax_id": "<string>",
        "employment_country": "DE",
        "child_allowances": "0.0",
        "factor_procedure": false,
        "factor": 123,
        "tax_allowance_amount": "0.00",
        "additional_taxable_amount": "0.00",
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25",
        "church_member": false
      },
      "employment_country": "DE",
      "external_ref": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25",
      "birth_place": "<string>",
      "birth_country": "<string>",
      "personal_email": "jsmith@example.com",
      "work_email": "jsmith@example.com",
      "phone_numbers": [
        {
          "phone_number": "<string>",
          "is_primary": false
        }
      ],
      "previous_employee_id": "<string>",
      "next_employee_id": "<string>"
    },
    "bank_accounts": [
      {
        "financial_institution_name": "<string>",
        "id": "<string>",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "account_number": "DE: DE89370400440532013000",
        "routing_number": "DE: 370400440",
        "iban": "DE: DE89370400440532013000",
        "swift_code": "DE: COBADEFFXXX",
        "account_details": {},
        "is_active": true,
        "is_primary": false
      }
    ],
    "pay_group_id": "<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
employee_data
DEEmployee · object
required

Schema for German employee data.

bank_accounts
BankAccountRequest · object[] | null

List of bank accounts associated with the employee

pay_group_id

Pay group ID for the employee

Response

Successful Response

id
string
required

Unique employee identifier

organization_id
string
required

Employee's organization

created_at
string<date-time> | null
required

Employee record creation timestamp

updated_at
string<date-time> | null
required

Employee record last update timestamp

employee_data
DEEmployeeResponse · object
required

Country-specific employee data with IDs and timestamps

bank_accounts
BankAccountResponse · object[]
required

Employee bank accounts

pay_group_id
string | null

Pay group ID for the employee