Account Holders

Register your end user customers or businesses as an Account Holder.

Create an Account Holder

1. Make a POST request to https://sandbox.conduit.financial/account-holders with the following body:

Copy
Copied
{
  "data": {
    "type": "account-holder",
    "attributes": {
      "firstName": "John",
      "lastName": "Snow",
      "middleName": "Marvolo",
      "address": {
        "street": "21 Jump Street",
        "apt_suite_flat_etc": "Apt 21",
        "city": "Boston",
        "postal_zip_code": "02111",
        "country": "USA"
      },
      "dateOfBirth": "2019-08-24",
      "nationality": "USA",
      "externalId": "null"
    }
  }
}

2. If successful, you will see a similar response from the API:

Tip

Note down the id attribute to be used to create an account.

Copy
Copied
{
  "data": {
    "id": "id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0",
    "type": "account-holder",
    "attributes": {
      "externalId": "null",
      "firstName": "John",
      "lastName": "Snow",
      "middleName": "Marvolo",
      "verificationStatus": "pending",
      "address": {
        "street": "21 Jump Street",
        "apt_suite_flat_etc": "Apt 21",
        "city": "Boston",
        "postal_zip_code": "02111",
        "country": "USA"
      },
      "dateOfBirth": "2019-08-24",
      "nationality": "USA"
    },
    "relationships": {
      "accounts": {
        "links": {
          "first": "/account-holders/id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0/relationships/accounts",
          "self": "/account-holders/id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0/relationships/accounts",
          "related": "/account-holders/id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0/accounts",
          "prev": null,
          "next": null
        },
        "data": []
      }
    }
  }
}

Next Steps

Now that you've successfully created your first Account Holder, let's create an account.