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:
{
"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.
{
"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.