Deel: Create an immigration case — request body — body data case type: BUSINESS VISA employee details

API reference · Contract 2026-10-27

SDK schema: Create an immigration case — request body — body / data / case_type: BUSINESS VISA employee details

Field	Type	Presence	Description and constraints
$	object	Root	Employee information. Citizenships and residence attributes are always required for business visa cases. The remaining fields are only required when no contract_id is present.
citizenships	array	Required within parent	List of ISO 3166-1 alpha-2 country codes representing employee’s citizenships
citizenships[]	string	Each item	Maximum length: 2 Minimum length: 2
email	string	Optional	Employee’s email address. Required if contract_id is not provided Format: email Maximum length: 255 Minimum length: 3
first_name	string	Optional	Employee’s first name. Required if contract_id is not provided Maximum length: 100 Minimum length: 3
last_name	string	Optional	Employee’s last name. Required if contract_id is not provided Maximum length: 100 Minimum length: 3
residence	string	Required within parent	ISO 3166-1 alpha-2 country code of employee’s current residence Maximum length: 2 Minimum length: 2