Skip to main content
Input object Input for registering a new business.

​
Input fields

​
String!
required
Legal business name.
​
String
Doing Business As name (optional).
​
BusinessStructureType!
required
Business structure type.
​
BusinessLegalAddressInput!
required
Business legal address.
​
String!
required
State of incorporation.
​
String!
required
Tax ID / EIN Number. Must be in format XX-XXXXXXX (2 digits, hyphen, 7 digits).
​
String
Optional URL to sole proprietorship documentation. Use the REST endpoint POST /api/v1/file-upload/business-application-document with documentType=SOLE_PROPRIETORSHIP to upload the file first and get the URL. Must be an absolute http/https URL of at most 255 characters.
​
String
URL of the authorized signer’s authorization document (e.g. corporate resolution, power of attorney). Required when the applicant has less than 25% ownership and is not the control person. Use the REST endpoint POST /api/v1/file-upload/business-application-document with documentType=AUTHORIZED_SIGNER to upload the file first and get the URL. Must be an absolute http/https URL of at most 255 characters.
​
UUID!
required
Business category ID (from getBusinessCategories query).
​
UUID!
required
Business sub-category ID (from getBusinessCategories query).
​
String
Brief description of the nature of business (optional).
​
String
Business website URL (optional).
​
[BusinessAccountUsageType]
Business account usage types. Must be one of the predefined enum values. If businessAccountUsage is not provided or is empty, businessAccountUsageOther must be filled.
​
String
Other business account usage description. Required if businessAccountUsage is not provided or is empty.
​
String
Optional external reference ID stored on the OAuth user record for this business account.
​
RegisterBusinessConfirmInput!
required
Ownership roster certifications. See RegisterBusinessConfirmInput for field requirements.
​
[BusinessOwnerInput!]!
required
List of business owners.Roster rules:
  • At least one owner is required.
  • Exactly one owner must have isControlPerson: true.
  • Exactly one owner must match the bearer token user by email or phone (the applicant).
  • Total ownershipPercentage across all owners must not exceed 100.
  • When businessStructure is SOLE_PROPRIETORSHIP: exactly one owner, that owner must be the control person with 100% ownership.
Per-owner data requirements:
  • isUsPerson is required on every owner, regardless of role.
  • Applicant, invited owners, and non-beneficial owners (< 25%, not control person): base fields only.
  • All other owners: base fields plus dob and address (lastFourSsnDigits also required when isUsPerson is true).