POST
/
beneficial-owners
/
{id}
cURL
POST https://api-sandbox.dwolla.com/beneficial-owners/07d59716-ef22-4fe6-98e8-f3190233dfb8
Content-Type: application/vnd.dwolla.v1.hal+json
Accept: application/vnd.dwolla.v1.hal+json
Authorization: Bearer pBA9fVDBEyYZCEsLf/wKehyh1RTpzjUj5KzIRfDi0wKTii7DqY

{
  "firstName": "beneficial",
  "lastName": "owner",
  "ssn": "123-54-6789",
  "dateOfBirth": "1963-11-11",
  "address": {
    "address1": "123 Main St.",
    "address2": "Apt 123",
    "city": "Des Moines",
    "stateProvinceRegion": "IA",
    "country": "US",
    "postalCode": "50309"
  }
}
{
  "_links": {},
  "id": "d3d6b41e-5567-4bc6-9c6e-0efd0a3e647e",
  "firstName": "<string>",
  "lastName": "<string>",
  "address": {
    "address1": "462 Main Street",
    "address2": "Suite 123",
    "address3": "Unit 123",
    "city": "Des Moines",
    "postalCode": "50309",
    "country": "USA",
    "stateProvinceRegion": "IA"
  },
  "verificationStatus": "verified",
  "created": "2022-07-23T00:18:21.419Z"
}

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

Beneficial owner unique identifier

Body

application/json

Parameters for updating a beneficial owner

Create a US Beneficial Owner (identified by SSN)

Response

200
application/vnd.dwolla.v1.hal+json

successful operation

Request body model for a Beneficial Owner