CreateAccountHolderRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/main/json-schema/adyen-create-account-holder-request-schema.json",
  "title": "CreateAccountHolderRequest",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/adyen-createaccountholder-api-openapi.yml#/components/schemas/CreateAccountHolderRequest",
  "properties": {
    "accountHolderCode": {
      "description": "Your unique identifier for the prospective account holder.\nThe length must be between three (3) and fifty (50) characters long. Only letters, digits, and hyphens (-) are allowed.",
      "type": "string"
    },
    "accountHolderDetails": {
      "description": "The details of the prospective account holder.",
      "$ref": "#/$defs/AccountHolderDetails"
    },
    "createDefaultAccount": {
      "description": "If set to **true**, an account with the default options is automatically created for the account holder.\nBy default, this field is set to **true**.",
      "type": "boolean"
    },
    "description": {
      "x-addedInVersion": "4",
      "description": "A description of the prospective account holder, maximum 256 characters. You can use alphanumeric characters (A-Z, a-z, 0-9), white spaces, and underscores `_`.",
      "type": "string"
    },
    "legalEntity": {
      "description": "The legal entity type of the account holder. This determines the information that should be provided in the request.\n\nPossible values: **Business**, **Individual**, or **NonProfit**.\n\n* If set to **Business** or **NonProfit**, then `accountHolderDetails.businessDetails` must be provided, with at least one entry in the `accountHolderDetails.businessDetails.shareholders` list.\n\n* If set to **Individual**, then `accountHolderDetails.individualDetails` must be provided.",
      "enum": [
        "Business",
        "Individual",
        "NonProfit",
        "Partnership",
        "PublicCompany"
      ],
      "type": "string"
    },
    "primaryCurrency": {
      "x-addedInVersion": "4",
      "deprecated": true,
      "description": "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), with which the prospective account holder primarily deals.",
      "type": "string"
    },
    "processingTier": {
      "x-addedInVersion": "3",
      "description": "The starting [processing tier](https://docs.adyen.com/marketplaces-and-platforms/classic/onboarding-and-verification/precheck-kyc-information) for the prospective account holder.",
      "format": "int32",
      "type": "integer"
    },
    "verificationProfile": {
      "x-addedInVersion": "6",
      "description": "The identifier of the profile that applies to this entity.",
      "type": "string"
    }
  },
  "required": [
    "accountHolderCode",
    "legalEntity",
    "accountHolderDetails"
  ],
  "type": "object",
  "$defs": {
    "AccountHolderDetails": {
      "properties": {
        "address": {
          "description": "The address of the account holder.",
          "$ref": "#/$defs/ViasAddress"
        },
        "bankAccountDetails": {
          "description": "Array of bank accounts associated with the account holder. For details about the required `bankAccountDetail` fields, see [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information).",
          "items": {
            "$ref": "#/$defs/BankAccountDetail"
          },
          "type": "array"
        },
        "bankAggregatorDataReference": {
          "x-addedInVersion": "5",
          "description": "The opaque reference value returned by the Adyen API during bank account login.",
          "type": "string"
        },
        "businessDetails": {
          "description": "Details about the business or nonprofit account holder.\nRequired when creating an account holder with `legalEntity` **Business** or **NonProfit**.",
          "$ref": "#/$defs/BusinessDetails"
        },
        "email": {
          "description": "The email address of the account holder.",
          "type": "string"
        },
        "fullPhoneNumber": {
          "description": "The phone number of the account holder provided as a single string. It will be handled as a landline phone.\n**Examples:** \"0031 6 11 22 33 44\", \"+316/1122-3344\", \"(0031) 611223344\"",
          "type": "string"
        },
        "individualDetails": {
          "description": "Details about the individual account holder.\nRequired when creating an account holder with `legalEntity` **Individual**.\n",
          "$ref": "#/$defs/IndividualDetails"
        },
        "lastReviewDate": {
          "description": "Date when you last reviewed the account holder's information, in ISO-8601 YYYY-MM-DD format. For example, **2020-01-31**.",
          "type": "string"
        },
        "legalArrangements": {
          "x-addedInVersion": "6",
          "description": "An array containing information about the account holder's [legal arrangements](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/legal-arrangements).",
          "items": {
            "$ref": "#/$defs/LegalArrangementDetail"
          },
          "type": "array"
        },
        "merchantCategoryCode": {
          "description": "The Merchant Category Code of the account holder.\n> If not specified in the request, this will be derived from the platform account (which is configured by Adyen).",
          "type": "string"
        },
        "metadata": {
          "additionalProperties": {
            "type": "string"
          },
          "description": "A set of key and value pairs for general use by the account holder or merchant.\nThe keys do not have specific names and may be used for storing miscellaneous data as desired.\n> The values being stored have a maximum length of eighty (80) characters and will be truncated if necessary.\n> Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs.",
          "type": "object"
        },
        "payoutMethods": {
          "x-addedInVersion": "5",
          "description": "Array of tokenized card details associated with the account holder. For details about how you can use the tokens to pay out, refer to [Pay out to cards](https://docs.adyen.com/marketplaces-and-platforms/classic/payout-to-cards).",
          "items": {
            "$ref": "#/$defs/PayoutMethod"
          },
          "type": "array"
        },
        "principalBusinessAddress": {
          "description": "The principal business address of the account holder.",
          "$ref": "#/$defs/ViasAddress"
        },
        "storeDetails": {
          "x-addedInVersion": "5",
          "description": "Array of stores associated with the account holder. Required when onboarding account holders that have an Adyen [point of sale](https://docs.adyen.com/marketplaces-and-platforms/classic/platforms-for-pos).",
          "items": {
            "$ref": "#/$defs/StoreDetail"
          },
          "type": "array"
        },
        "webAddress": {
          "description": "The URL of the website of the account holder.",
          "type": "string"
        }
      },
      "required": [
        "address"
      ],
      "type": "object"
    },
    "BankAccountDetail": {
      "properties": {
        "accountNumber": {
          "description": "The bank account number (without separators).\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "accountType": {
          "description": "The type of bank account.\nOnly applicable to bank accounts held in the USA.\nThe permitted values are: `checking`, `savings`.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "bankAccountName": {
          "description": "The name of the bank account.",
          "type": "string"
        },
        "bankAccountReference": {
          "x-addedInVersion": "5",
          "description": "Merchant reference to the bank account.",
          "type": "string"
        },
        "bankAccountUUID": {
          "description": "The unique identifier (UUID) of the Bank Account.\n>If, during an account holder create or update request, this field is left blank (but other fields provided), a new Bank Account will be created with a procedurally-generated UUID.\n\n>If, during an account holder create request, a UUID is provided, the creation of the Bank Account will fail while the creation of the account holder will continue.\n\n>If, during an account holder update request, a UUID that is not correlated with an existing Bank Account is provided, the update of the account holder will fail.\n\n>If, during an account holder update request, a UUID that is correlated with an existing Bank Account is provided, the existing Bank Account will be updated.\n",
          "type": "string"
        },
        "bankBicSwift": {
          "description": "The bank identifier code.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "bankCity": {
          "description": "The city in which the bank branch is located.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "bankCode": {
          "description": "The bank code of the banking institution with which the bank account is registered.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "bankName": {
          "description": "The name of the banking institution with which the bank account is held.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "branchCode": {
          "description": "The branch code of the branch under which the bank account is registered. The value to be specified in this parameter depends on the country of the bank account:\n* United States - Routing number\n* United Kingdom - Sort code\n* Germany - Bankleitzahl\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "checkCode": {
          "description": "The check code of the bank account.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "countryCode": {
          "description": "The two-letter country code in which the bank account is registered.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "currencyCode": {
          "description": "The currency in which the bank account deals.\n>The permitted currency codes are defined in ISO-4217 (e.g. 'EUR').\n",
          "type": "string"
        },
        "iban": {
          "description": "The international bank account number.\n>The IBAN standard is defined in ISO-13616.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerCity": {
          "description": "The city of residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerCountryCode": {
          "description": "The country code of the country of residence of the bank account owner.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerDateOfBirth": {
          "deprecated": true,
          "description": "The date of birth of the bank account owner.\nThe date should be in ISO-8601 format yyyy-mm-dd (e.g. 2000-01-31).",
          "type": "string"
        },
        "ownerHouseNumberOrName": {
          "description": "The house name or number of the residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerName": {
          "description": "The name of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerNationality": {
          "description": "The country code of the country of nationality of the bank account owner.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerPostalCode": {
          "description": "The postal code of the residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerState": {
          "description": "The state of residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "ownerStreet": {
          "description": "The street name of the residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "primaryAccount": {
          "description": "If set to true, the bank account is a primary account.",
          "type": "boolean"
        },
        "taxId": {
          "description": "The tax ID number.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        },
        "urlForVerification": {
          "description": "The URL to be used for bank account verification.\nThis may be generated on bank account creation.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "BusinessDetails": {
      "properties": {
        "doingBusinessAs": {
          "description": "The registered name of the company (if it differs from the legal name of the company).",
          "type": "string"
        },
        "legalBusinessName": {
          "description": "The legal name of the company.",
          "type": "string"
        },
        "listedUltimateParentCompany": {
          "description": "Information about the parent public company. Required if the account holder is 100% owned by a publicly listed company.",
          "items": {
            "$ref": "#/$defs/UltimateParentCompany"
          },
          "type": "array"
        },
        "registrationNumber": {
          "x-addedInVersion": "4",
          "description": "The registration number of the company.",
          "type": "string"
        },
        "shareholders": {
          "description": "Array containing information about individuals associated with the account holder either through ownership or control. For details about how you can identify them, refer to [our verification guide](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process#identify-ubos).",
          "items": {
            "$ref": "#/$defs/ShareholderContact"
          },
          "type": "array"
        },
        "signatories": {
          "description": "Signatories associated with the company.\nEach array entry should represent one signatory.",
          "items": {
            "$ref": "#/$defs/SignatoryContact"
          },
          "type": "array"
        },
        "stockExchange": {
          "x-addedInVersion": "6",
          "description": "Market Identifier Code (MIC).",
          "type": "string"
        },
        "stockNumber": {
          "x-addedInVersion": "6",
          "description": "International Securities Identification Number (ISIN).",
          "type": "string"
        },
        "stockTicker": {
          "x-addedInVersion": "6",
          "description": "Stock Ticker symbol.",
          "type": "string"
        },
        "taxId": {
          "description": "The tax ID of the company.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "IndividualDetails": {
      "properties": {
        "name": {
          "description": "The name of the individual.\n>Make sure your account holder registers using the name shown on their Photo ID.",
          "$ref": "#/$defs/ViasName"
        },
        "personalData": {
          "description": "Personal information of the individual.",
          "$ref": "#/$defs/ViasPersonalData"
        }
      },
      "type": "object"
    },
    "LegalArrangementDetail": {
      "properties": {
        "address": {
          "description": "The address of the legal arrangement.",
          "$ref": "#/$defs/ViasAddress"
        },
        "legalArrangementCode": {
          "description": "Adyen-generated unique alphanumeric identifier (UUID) for the entry, returned in the response when you create a legal arrangement.\nUse only when updating an account holder. If you include this field when creating an account holder, the request will fail.",
          "type": "string"
        },
        "legalArrangementEntities": {
          "description": "An array containing information about other entities that are part of the legal arrangement.",
          "items": {
            "$ref": "#/$defs/LegalArrangementEntityDetail"
          },
          "type": "array"
        },
        "legalArrangementReference": {
          "description": "Your reference for the legal arrangement. Must be between 3 to 128 characters.",
          "type": "string"
        },
        "legalForm": {
          "description": "The form of legal arrangement. Required if `type` is **Trust** or **Partnership**.\n\nThe possible values depend on the `type`.\n\n- For `type` **Trust**:  **CashManagementTrust**, **CorporateUnitTrust**, **DeceasedEstate**, **DiscretionaryInvestmentTrust**, **DiscretionaryServicesManagementTrust**, **DiscretionaryTradingTrust**, **FirstHomeSaverAccountsTrust**, **FixedTrust**, **FixedUnitTrust**, **HybridTrust**, **ListedPublicUnitTrust**, **OtherTrust**, **PooledSuperannuationTrust**, **PublicTradingTrust**, or **UnlistedPublicUnitTrust**.\n\n- For `type` **Partnership**: **LimitedPartnership**, **FamilyPartnership**, or **OtherPartnership**",
          "enum": [
            "CashManagementTrust",
            "CorporateUnitTrust",
            "DeceasedEstate",
            "DiscretionaryInvestmentTrust",
            "DiscretionaryServicesManagementTrust",
            "DiscretionaryTradingTrust",
            "FirstHomeSaverAccountsTrust",
            "FixedTrust",
            "FixedUnitTrust",
            "HybridTrust",
            "ListedPublicUnitTrust",
            "OtherTrust",
            "PooledSuperannuationTrust",
            "PublicTradingTrust",
            "UnlistedPublicUnitTrust",
            "LimitedPartnership",
            "FamilyPartnership",
            "OtherPartnership"
          ],
          "type": "string"
        },
        "name": {
          "description": "The legal name of the legal arrangement. Minimum length: 3 characters.",
          "type": "string"
        },
        "registrationNumber": {
          "description": "The registration number of the legal arrangement.",
          "type": "string"
        },
        "taxNumber": {
          "description": "The tax identification number of the legal arrangement.",
          "type": "string"
        },
        "type": {
          "description": "The [type of legal arrangement](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/legal-arrangements#types-of-legal-arrangements).\n\nPossible values:\n\n- **Association** \n\n- **Partnership** \n\n- **SoleProprietorship** \n\n- **Trust** \n\n",
          "enum": [
            "Association",
            "Partnership",
            "SoleProprietorship",
            "Trust"
          ],
          "type": "string"
        }
      },
      "required": [
        "type",
        "name",
        "address"
      ],
      "type": "object"
    },
    "LegalArrangementEntityDetail": {
      "properties": {
        "address": {
          "description": "The address of the entity.",
          "$ref": "#/$defs/ViasAddress"
        },
        "businessDetails": {
          "description": "Required when creating an entity with `legalEntityType` **Business**, **NonProfit**, **PublicCompany**, or **Partnership**.",
          "$ref": "#/$defs/BusinessDetails"
        },
        "email": {
          "description": "The e-mail address of the entity.",
          "type": "string"
        },
        "fullPhoneNumber": {
          "description": "The phone number of the contact provided as a single string.  It will be handled as a landline phone.\n**Examples:** \"0031 6 11 22 33 44\", \"+316/1122-3344\", \"(0031) 611223344\"",
          "type": "string"
        },
        "individualDetails": {
          "description": "Required when creating an entity with `legalEntityType` **Individual**.",
          "$ref": "#/$defs/IndividualDetails"
        },
        "legalArrangementEntityCode": {
          "description": "Adyen-generated unique alphanumeric identifier (UUID) for the entry, returned in the response when you create a legal arrangement entity.\nUse only when updating an account holder. If you include this field when creating an account holder, the request will fail.",
          "type": "string"
        },
        "legalArrangementEntityReference": {
          "description": "Your reference for the legal arrangement entity.",
          "type": "string"
        },
        "legalArrangementMembers": {
          "description": "An array containing the roles of the entity in the legal arrangement.\n\nThe possible values depend on the legal arrangement `type`.\n\n- For `type` **Association**: **ControllingPerson** and **Shareholder**.\n\n- For `type` **Partnership**: **Partner** and **Shareholder**.\n\n- For `type` **Trust**: **Trustee**, **Settlor**, **Protector**, **Beneficiary**,  and **Shareholder**.\n\n",
          "items": {
            "enum": [
              "Beneficiary",
              "ControllingPerson",
              "Partner",
              "Protector",
              "Settlor",
              "Shareholder",
              "Trustee"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "legalEntityType": {
          "description": "The legal entity type.\n\nPossible values: **Business**, **Individual**, **NonProfit**, **PublicCompany**, or **Partnership**. ",
          "enum": [
            "Business",
            "Individual",
            "NonProfit",
            "Partnership",
            "PublicCompany"
          ],
          "type": "string"
        },
        "phoneNumber": {
          "description": "The phone number of the entity.",
          "$ref": "#/$defs/ViasPhoneNumber"
        },
        "webAddress": {
          "description": "The URL of the website of the contact.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "PayoutMethod": {
      "properties": {
        "merchantAccount": {
          "description": "The [`merchantAccount`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_merchantAccount) you used in the `/payments` request when you [saved the account holder's card details](https://docs.adyen.com/marketplaces-and-platforms/classic/payouts/manual-payout/payout-to-cards#check-and-store).",
          "type": "string"
        },
        "payoutMethodCode": {
          "description": "Adyen-generated unique alphanumeric identifier (UUID) for the payout method, returned in the response when you create a payout method. Required when updating an existing payout method in an `/updateAccountHolder` request.",
          "type": "string"
        },
        "payoutMethodReference": {
          "description": "Your reference for the payout method.",
          "type": "string"
        },
        "recurringDetailReference": {
          "description": "The [`recurringDetailReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_additionalData-ResponseAdditionalDataCommon-recurring-recurringDetailReference)  returned in the `/payments` response when you [saved the account holder's card details](https://docs.adyen.com/marketplaces-and-platforms/classic/payouts/manual-payout/payout-to-cards#check-and-store).",
          "type": "string"
        },
        "shopperReference": {
          "description": "The [`shopperReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__reqParam_shopperReference) you sent in the `/payments` request when you [saved the account holder's card details](https://docs.adyen.com/marketplaces-and-platforms/classic/payouts/manual-payout/payout-to-cards#check-and-store).",
          "type": "string"
        }
      },
      "required": [
        "merchantAccount",
        "shopperReference",
        "recurringDetailReference"
      ],
      "type": "object"
    },
    "PersonalDocumentData": {
      "properties": {
        "expirationDate": {
          "description": "The expiry date of the document, \n in ISO-8601 YYYY-MM-DD format. For example, **2000-01-31**.",
          "type": "string"
        },
        "issuerCountry": {
          "description": "The country where the document was issued, in the two-character \n[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. For example, **NL**.",
          "maxLength": 2,
          "minLength": 2,
          "type": "string"
        },
        "issuerState": {
          "description": "The state where the document was issued (if applicable).",
          "type": "string"
        },
        "number": {
          "description": "The number in the document.",
          "type": "string"
        },
        "type": {
          "description": "The type of the document. Possible values: **ID**, **DRIVINGLICENSE**, **PASSPORT**, **SOCIALSECURITY**, **VISA**.\n\nTo delete an existing entry for a document `type`, send only the `type` field in your request. ",
          "enum": [
            "DRIVINGLICENSE",
            "ID",
            "PASSPORT",
            "SOCIALSECURITY",
            "VISA"
          ],
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "ShareholderContact": {
      "properties": {
        "address": {
          "description": "The address of the person.",
          "$ref": "#/$defs/ViasAddress"
        },
        "email": {
          "description": "The e-mail address of the person.",
          "type": "string"
        },
        "fullPhoneNumber": {
          "description": "The phone number of the person provided as a single string.  It will be handled as a landline phone.\nExamples: \"0031 6 11 22 33 44\", \"+316/1122-3344\", \"(0031) 611223344\"",
          "type": "string"
        },
        "jobTitle": {
          "description": "Job title of the person. Required when the `shareholderType` is **Controller**.\n\nExample values: **Chief Executive Officer**, **Chief Financial Officer**, **Chief Operating Officer**, **President**, **Vice President**, **Executive President**, **Managing Member**, **Partner**, **Treasurer**, **Director**, or **Other**.",
          "type": "string"
        },
        "name": {
          "description": "The name of the person.",
          "$ref": "#/$defs/ViasName"
        },
        "personalData": {
          "description": "Contains information about the person.",
          "$ref": "#/$defs/ViasPersonalData"
        },
        "phoneNumber": {
          "description": "The phone number of the person.",
          "$ref": "#/$defs/ViasPhoneNumber"
        },
        "shareholderCode": {
          "description": "The unique identifier (UUID) of the shareholder entry.\n>**If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Shareholder will be created with a procedurally-generated UUID.**\n\n>**If, during an Account Holder create request, a UUID is provided, the creation of Account Holder will fail with a validation Error..**\n\n>**If, during an Account Holder update request, a UUID that is not correlated with an existing Shareholder is provided, the update of the Shareholder will fail.**\n\n>**If, during an Account Holder update request, a UUID that is correlated with an existing Shareholder is provided, the existing Shareholder will be updated.**\n",
          "type": "string"
        },
        "shareholderReference": {
          "x-addedInVersion": "5",
          "description": "Your reference for the shareholder entry.",
          "type": "string"
        },
        "shareholderType": {
          "description": "Specifies how the person is associated with the account holder. \n\nPossible values: \n\n* **Owner**: Individuals who directly or indirectly own 25% or more of a company.\n\n* **Controller**: Individuals who are members of senior management staff responsible for managing a company or organization.",
          "enum": [
            "Controller",
            "Owner",
            "Signatory"
          ],
          "type": "string"
        },
        "webAddress": {
          "description": "The URL of the person's website.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "SignatoryContact": {
      "properties": {
        "address": {
          "description": "The address of the person.",
          "$ref": "#/$defs/ViasAddress"
        },
        "email": {
          "description": "The e-mail address of the person.",
          "type": "string"
        },
        "fullPhoneNumber": {
          "description": "The phone number of the person provided as a single string.  It will be handled as a landline phone.\nExamples: \"0031 6 11 22 33 44\", \"+316/1122-3344\", \"(0031) 611223344\"",
          "type": "string"
        },
        "jobTitle": {
          "description": "Job title of the signatory.\n\nExample values: **Chief Executive Officer**, **Chief Financial Officer**, **Chief Operating Officer**, **President**, **Vice President**, **Executive President**, **Managing Member**, **Partner**, **Treasurer**, **Director**, or **Other**.",
          "type": "string"
        },
        "name": {
          "description": "The name of the person.",
          "$ref": "#/$defs/ViasName"
        },
        "personalData": {
          "

# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-schema/adyen-create-account-holder-request-schema.json