Creates a German employee datum

post

https://api.factorialhr.com/api/2026-10-01/resources/payroll_employees/german_employee_data

Creates the German-specific payroll data record for an employee

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

employee_id

string

required

Identifier of the employee

work_permit_expiration_date

string

Expiration date of the employee's work permit

residency_permit_expiration_date

string

Expiration date of the employee's residence permit

certificate_of_study_expiration_date

string

Expiration date of the employee's certificate of study

health_insurer_company_number

string

Company number of the employee's health insurance company

contribution_class_health_insurance

integer

Health insurance contribution class. 0: No contribution (private health insurance or voluntary health insurance as self-payer), 1: General contribution, 3: Reduced contribution, 4: Contribution to agricultural health insurance, 5: Employer's contribution to agricultural health insurance, 6: Flat-rate contribution for marginal employees, 9: Corporate payer

contribution_class_unemployment_insurance

integer

Unemployment insurance contribution class. 0: No contribution, 1: Full contribution, 2: Half contribution

contribution_class_pension_insurance

integer

Pension insurance contribution class. 0: No contribution, 1: Full contribution, 3: Half contribution, 5: Flat-rate contribution for marginal employees

contribution_class_nursing_insurance

integer

Long-term (nursing) insurance contribution class. 0: No contribution, 1: Full contribution, 2: Half contribution

additional_contribution_to_nursing_insurance

boolean

Whether the employee pays an additional contribution to the nursing insurance institution

tax_class

integer

Tax class of the employee

requested_annual_allowance

integer

Requested annual tax allowance

factor

number

Factor used for the factor method (Faktorverfahren) in German income tax

annual_tax_allowance

integer

Annual tax allowance

monthly_tax_allowance

integer

Monthly tax allowance

child_tax_allowance

number

Child tax allowance

denomination

string

Denomination of the employee. ev: Protestant Church Tax, rk: Roman Catholic Church Tax, ak: Old Catholic Church Tax, fa: Free Religious Community Alzey, fb: Free Religious State Community Baden, fg: Free Religious State Community Palatinate, fm: Free Religious Community Mainz, fr: French Reformed (until 12/2015), fs: Free Religious Community Offenbach/Main, ib: Israelite Religious Community Baden, ih: Jewish Cult Tax, il: Israelite Cult Tax of Cult-Entitled Communities, is: Israelite / Jewish Cult Tax, iw: Israelite Religious Community Württemberg, jd: Jewish Cult Tax, jh: Jewish Cult Tax, lt: Evangelical Lutheran (until 12/2015), rf: Evangelical Reformed (until 12/2015), nd: Non-denominational

spouses_denomination

string

Denomination of the employee's spouse. ev: Protestant Church Tax, rk: Roman Catholic Church Tax, ak: Old Catholic Church Tax, fa: Free Religious Community Alzey, fb: Free Religious State Community Baden, fg: Free Religious State Community Palatinate, fm: Free Religious Community Mainz, fr: French Reformed (until 12/2015), fs: Free Religious Community Offenbach/Main, ib: Israelite Religious Community Baden, ih: Jewish Cult Tax, il: Israelite Cult Tax of Cult-Entitled Communities, is: Israelite / Jewish Cult Tax, iw: Israelite Religious Community Württemberg, jd: Jewish Cult Tax, jh: Jewish Cult Tax, lt: Evangelical Lutheran (until 12/2015), rf: Evangelical Reformed (until 12/2015), nd: Non-denominational

personnel_leasing

integer

Personnel leasing status of the employee. 0: such as client data, 1: no, 2: yes

highest_level_of_professional_training

integer

Highest level of professional training of the employee. 0: No specification, 1: Without vocational qualification, 2: Completion of recognized vocational training, 3: Master craftsman/technician or equivalent technical school degree, 4: Bachelor, 5: Diploma/Magister/Master/State examination, 6: Doctorate, 9: Qualification unknown

highest_level_of_education

integer

Highest level of education of the employee. 0: No specification, 1: Without school qualification, 2: Secondary school diploma, 3: Intermediate school diploma or equivalent, 4: High school diploma/vocational diploma, 9: Qualification unknown

Response

201CREATED