Deel: Create a tax form for the authenticated worker — request body — body data form type: W8 BEN tax treaty benefits form article and paragraph, details, owner resident country, type of income, withholding rate

API reference · Contract 2026-10-27

SDK schema: Create a tax form for the authenticated worker — request body — body / data / form_type: W8 BEN tax treaty benefits form article and paragraph, details, owner resident country, type of income, withholding rate

Field	Type	Presence	Description and constraints
$	object	Root	Tax treaty benefits details. Applicable when is_tax_treaty_enabled is true.
article_and_paragraph	string	Optional	Article and paragraph of the applicable tax treaty. Maximum length: 100
details	string	Optional	Additional details about the treaty claim. Maximum length: 400
owner_resident_country	string	Optional	Country of residence of the beneficial owner. Must be a US income tax treaty country. Maximum length: 2 Minimum length: 2 Pattern: ^[A-Z]{2}$
type_of_income	string	Optional	Type of income covered by the treaty. Maximum length: 100
withholding_rate	number	Optional	Withholding rate under the treaty (percentage). Format: double Maximum: 100 Minimum: 0