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>"
}
]
}Employees
Create Employees
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
Get token from Auth0 and paste it here
Path Parameters
Body
application/json
Response
Successful Response
Unique employee identifier
Employee's organization
Employee record creation timestamp
Employee record last update timestamp
Country-specific employee data with IDs and timestamps
- DEEmployeeResponse
- GBEmployeeResponse
Show child attributes
Show child attributes
Employee bank accounts
Show child attributes
Show child attributes
Pay group ID for the employee
⌘I