Account Holders

Register your users as Account Holders in order to create accounts for them to manage crypto assets.

Create an Account Holder

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

Copy
Copied
{
    "data": {
        "attributes": {
            "firstName": "John",
            "lastName": "Snow"
        }
    }
}

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",
      "verificationStatus": "PENDING"
    },
    "relationships": {
      "accounts": {
        "links": {
          "next": null,
          "self": "/account-holders/id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0/relationships/accounts",
          "related": "/account-holders/id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0/accounts"
        },
        "data": []
      }
    }
  }
}

Next Steps

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