Skip to content

Deel: Create child organization — request body — body data child organization

Create child organization: request body, field body / data / child_organization. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Create child organization — request body — body data child organization

FieldTypePresenceDescription and constraints
$objectRootThe object that contains all the information related to the child organization that will be created.
departmentstringOptionalThe department’s name where the manager will be added. Defaults to “Founder” when omitted.
Default: Founder
Maximum length: 255
headquarters_countrystringOptionalThe organization’s headquarters country as an ISO 3166-1 alpha-2 code. Validated against Deel’s country whitelist; unknown codes are rejected.
Maximum length: 2
Minimum length: 2
is_api_enabledbooleanOptionalThe flag that enables the public API for the child organization. Defaults to false when omitted.
Default: false
namestringRequired within parentThe organization’s name.
Maximum length: 255
workforce_sizeintegerOptionalThe workforce size of the child organization.
Maximum: 1000000
Minimum: 1

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.