Create a new benefical owner for a Client

POST https://api-sandbox.dwolla.com/clients/{{clientAccountId}}/beneficial-owners

Create a new beneficial owner for a Client Account. To create beneficial owners, you need to collect the beneficial owner's full name, ssn, date of birth, and permanent address. Optionally, passport information must be included for non-US persons that do not have a US issued SSN. Beneficial owners require additional information that will give Dwolla the ability to confirm the identity of the individual.

Request parameters

Parameter	Required	Type	Description
firstName	yes	string	The legal first name of the beneficial owner.
lastName	yes	string	The legal last name of the beneficial owner.
ssn	yes	string	Full nine digits of beneficial owner’s social security number.
dateOfBirth	Yes	string	beneficial owner’s date of birth in `YYYY-MM-DD` format. Must be between 18 to 125 years of age.
address	yes	object	An address JSON object. Full address of the beneficial owner's physical address.

Address JSON object

Parameter	Required	Type	Description
address1	yes	string	First line of the street address of the beneficial owner's permanent residence. Note: PO Boxes are not allowed.
address2	no	string	Second line of the street address of the beneficial owner's permanent residence. Note: PO Boxes are not allowed.
address3	no	string	Third line of the street address of the beneficial owner's permanent residence. Note: PO Boxes are not allowed.
city	yes	string	City of beneficial owner's permanent residence.
stateProvinceRegion	yes	string	Two-letter US state abbreviation code of Beneficial owner’s physical address. For two-letter US state abbreviation reference, check out the US Postal Service guide.
country	yes	string	Country of beneficial owner's permanent residence. Two digit ISO code, e.g. `US`.
postalCode	conditional	string	Postal code of beneficial owner's permanent residence. Should be a five digit postal code, e.g. `50314`. Optional if beneficial owner is a non-US person.

HTTP status and error codes

HTTP Status	Code	Message	Description
201	Created	Success	Beneficial owner created.
400	BadRequest	Validation error(s) present. See embedded errors list for more details.	An error exists with the request. Check the embedded list of errors for more detailed error messages. Also check Validation Errors section in the API reference.
404	NotFound	The requested resource was not found.	Client Account not found. Check Client Account Id.

Request Body

{"firstName"=>"Beneficial", "lastName"=>"Owner", "ssn"=>"123-46-7890", "dateOfBirth"=>"1960-11-30", "address"=>{"address1"=>"123 Main St.", "city"=>"New York", "stateProvinceRegion"=>"NY", "country"=>"US", "postalCode"=>"10005"}}

HEADERS

Key	Datatype	Required	Description
`Content-Type`	string
`Accept`	string
`Authorization`	string