1. Create Account Holder

Create your first account holder using our Account Holder API

Postman

Code

curl --request POST \
     --url https://sandbox.lithic.com/v1/account_holders \
     --header "Accept: application/json" \
     --header "Authorization: {Sandbox API key}" \
     --header "Content-Type: application/json" \
     --data '
{
  "individual": {
    "address": {
      "address1": "123 Old Forest Way",
      "city": "Omaha",
      "country": "USA",
      "postal_code": "68022",
      "state": "NE"
    },
    "dob": "1991-03-08 08:00:00",
    "email": "[email protected]",
    "first_name": "Tom",
    "government_id": "111-23-1412",
    "last_name": "Bombadil",
    "phone_number": "+15555555555"
  },
  "tos_timestamp": "2022-03-08 08:00:00",
  "workflow": "KYC_BASIC"
}'

/*
const lithic = new Lithic({
  apiKey: "{Sandbox API key}", // or "Production API key"
  environment: "sandbox", // or "production". Defaults to "production"
});
*/

const accountHolderParams: Lithic.AccountHolderCreateParams = {
  individual: {
    address: {
      address1: "123 Old Forest Way",
      city: "Omaha",
      country: "USA",
      postal_code: "68022",
      state: "NE",
    },
    dob: "1991-03-08 08:00:00",
    email: "[email protected]",
    first_name: "Tom",
    government_id: "111-23-1412",
    last_name: "Bombadil",
    phone_number: "+15555555555",
  },
  tos_timestamp: "2022-03-08 08:00:00",
  workflow: "KYC_BASIC",
};
const accountHolder = await lithic.accountHolders.create(accountHolderParams);

'''
lithic = Lithic(
  api_key="{Sandbox API key}",  # or "Production API key"
  environment="sandbox",  # or "production". Defaults to "production"
)
'''

account_holder = lithic.account_holders.create(
    individual={
        "address": {
            "address1": "123 Old Forest Way",
            "city": "Omaha",
            "country": "USA",
            "postal_code": "68022",
            "state": "NE",
        },
        "dob": "1991-03-08 08:00:00",
        "email": "[email protected]",
        "first_name": "Tom",
        "government_id": "111-23-1412",
        "last_name": "Bombadil",
        "phone_number": "+15555555555",
    },
    tos_timestamp="2022-03-08 08:00:00",
    workflow="KYC_BASIC",
)

An account holder represents the individual or business that owns an account with Lithic. Creating one runs KYC or KYB and, on success, creates an associated account.

This example uses the KYC_BASIC workflow to onboard an individual account holder.

For more information on account holders, check out our in-depth guide: Account Holders (Individuals)