Skip to main content
POST
/
customers
/
{id}
/
beneficial-owners
cURL
POST https://api-sandbox.dwolla.com/customers/81696e5d-a593-45a6-8863-3c20ad634de5/beneficial-owners
Content-Type: application/vnd.dwolla.v1.hal+json
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY

{
  "firstName": "document",
  "lastName": "owner",
  "ssn": "123-46-7890",
  "dateOfBirth": "1960-11-30",
  "address": {
    "address1": "123 Main St.",
    "city": "New York",
    "stateProvinceRegion": "NY",
    "country": "US",
    "postalCode": "10005"
  }
}
{
  "code": "BadRequest",
  "message": "The request body contains bad syntax or is incomplete."
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
Accept
enum<string>
default:application/vnd.dwolla.v1.hal+json
required

The media type of the response. Must be application/vnd.dwolla.v1.hal+json

Available options:
application/vnd.dwolla.v1.hal+json

Path Parameters

​
id
string
required

Customer ID for which to create a Beneficial Owner

Body

application/json

Parameters for creating a beneficial owner

  • CreateUSBeneficialOwner
  • CreateInternationalBeneficialOwner

Create a US Beneficial Owner (identified by SSN). For US-based beneficial owners only. Use SSN for identity verification instead of passport.

​
firstName
string
required
Example:

"John"

​
lastName
string
required
Example:

"Doe"

​
dateOfBirth
string
required
Example:

"1980-01-31"

​
address
InternationalAddress · object
required
​
ssn
string
required
Example:

"123456789"

Response

successful operation