Skip to content

Deel: Create a new contract — 201 response body — data employment details

Create a new contract: 201 response body, field data / employment_details. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Create a new contract — 201 response body — data employment details

FieldTypePresenceDescription and constraints
$objectRootEmployment-related details for the contract, when applicable.
countrystringOptionalCountry code.
Maximum length: 2
Minimum length: 2
Pattern: ^[A-Z]{2}$
days_per_weekJSONRequired within parent
days_per_week (anyOf 1)numberAlternativeNumber of days per week
Format: double
days_per_week (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
hours_per_dayJSONRequired within parent
hours_per_day (anyOf 1)numberAlternativeNumber of hours per day
Format: double
hours_per_day (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
paid_vacation_daysJSONRequired within parent
paid_vacation_days (anyOf 1)numberAlternativeNumber of paid vacation days
Format: double
paid_vacation_days (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
probation_periodJSONRequired within parent
probation_period (anyOf 1)JSONAlternative
probation_period (anyOf 1) (anyOf 1)numberAlternativeNumber of days for probation period
Format: double
probation_period (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
probation_period (anyOf 2)nullAlternativeNumber of days for probation period
Format: double
stateJSONOptional
state (anyOf 1)stringAlternativeState code.
state (anyOf 2)nullAlternativeState code.
typestringRequired within parentEmployment type classification for the contract.

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.