---
title: "Create a Business Representative"
method: POST
path: "/v2/business-representative"
---

# Create a Business Representative

`POST /v2/business-representative`

Create a new business representative for a customer.

## Request body

- object
  - `customerId` string, required — The ID of the business customer this representative belongs to.
  - `type` 'individual', required — The type of the business representative. Must be "individual".
  - `email` string, email, required — The email address of the business representative.
  - `phone` string, required — The phone number of the business representative.
  - `firstName` string — The business representative's legal first name.
  - `lastName` string — The business representative's legal last name.
  - `middleName` string — The business representative's legal middle name.
  - `dateOfBirth` string — The business representative's date of birth in YYYY-MM-DD format.
  - `address` object, required — The address of the business representative.
    - `line1` string, required — The first line of the street address
    - `line2` string — The second line of the street address (apartment, suite, etc.)
    - `city` string, required — The city name
    - `state` string — The state or province code (ISO3166-2 subdivision code). Required for countries that have states/provinces. See State Codes.
    - `postalCode` string — The postal or ZIP code. Required for countries that use postal codes
    - `country` string, required — The ISO3166-1 Alpha-3 country code (e.g., USA, GBR, CAN). See [Country Codes](/concepts/reference/supported-countries).
  - `personalInformation` object, required — Personal information including tax identification details for individual customers. When any tax identification field is provided, all tax identification fields (number, type, country) and address are required. Please refer to the [Individual Verification Criteria](/concepts/onboarding/verification-profile) for the full list of reference.
    - `taxIdentificationNumber` string, required — The tax identification number. Required when providing tax identification information. Only alphanumeric characters (letters and numbers) are accepted - omit separators such as dashes or spaces (e.g. send "123456789", not "123-45-6789").
    - `taxIdentificationNumberType` string, required — The type of tax identification number of the customer. Required when providing tax identification information. Please refer to the [Individual Verification Criteria](/concepts/onboarding/verification-profile) for the full list of reference.
    - `taxIdentificationNumberCountry` string, required — The ISO3166-1 Alpha-3 country code for the tax identification number. Required when providing tax identification information. See [Country Codes](/concepts/reference/supported-countries).
    - `taxIdentificationNumberDescription` string — Description of the tax identification number. Required when type is `other`
    - `accountPurpose` 'personal_or_living_expenses' | 'payments_to_friends_or_family_abroad' | 'receive_salary' | 'receive_payment_for_freelancing' | 'protect_wealth' | 'purchase_goods_and_services' | 'charitable_donations' | 'ecommerce_retail_payments' | 'investment_purposes' | 'operating_a_company' — The purpose of the account. Required for EEA-resident individuals.
    - `gender` 'male' | 'female' | 'other' — The gender of the customer. Required by some verification providers.
    - `countryOfBirth` string — The ISO3166-1 Alpha-3 country code of the country where the customer was born. See [Country Codes](/concepts/reference/supported-countries).
    - `nationality` string — The ISO3166-1 Alpha-3 country code of the customer's nationality. Required by some verification providers. See [Country Codes](/concepts/reference/supported-countries).
    - `occupationSocCode` string — The customer's occupation as a 6-digit Standard Occupational Classification (SOC) code, validated against the supported occupation list. Required for some verification flows.
    - `residencyCountry` string — The ISO3166-1 Alpha-3 country code of the customer's country of residency. Often satisfied by the address country, but some verification providers require it as a separate attribute. See [Country Codes](/concepts/reference/supported-countries).
    - `sourceOfFunds` 'salary' | 'business_income' | 'investment_returns' | 'inheritance' | 'gift' | 'savings' | 'other' — The customer's primary source of funds. Required by some verification providers.
  - `representationDetails` object, required — The representation details of the business representative.
    - `roles` string[], required — The roles of the business representative. Currently the only accepted value is ["ubo"].
    - `ownershipPercentage` string, required — The ownership percentage of the business representative. Must be a positive integer between 25 and 100 (inclusive).
    - `isControlPerson` boolean, required — Whether the business representative has control over the company or able to make decisions on behalf of the company.
    - `isSigner` boolean, required — Whether the business representative is a signer on the company's documents.
    - `relationshipEstablishedAt` string, required — The date the business representative was established in the company.
    - `title` string — The title of the business representative.

## Response `201`

- BusinessRepresentativeResponseDto
  - `id` string, required — Business Representative ID
  - `customerId` string, required — Customer ID
  - `type` 'individual', required — Customer type
  - `email` string — Email address
  - `phone` string — Phone number
  - `representationDetails` object — Representation details
    - `roles` string[], required — The roles of the business representative.
    - `ownershipPercentage` string — The ownership percentage of the business representative.
    - `isControlPerson` boolean — Whether the business representative has control over the company.
    - `isSigner` boolean — Whether the business representative is a signer on the company's documents.
    - `relationshipEstablishedAt` string — The date the business representative was established in the company.
    - `title` string — The title of the business representative.
  - `verificationProfiles` object[], required — Array of verification profiles for the business representative.
    - `name` 'kyc_profile_a' | 'kyb_profile_a' | 'ubo_kyc_profile_a' | 'kyc_profile_b' | 'kyb_profile_b' | 'kyb_profile_c' | 'kyc_profile_c' | 'ubo_kyc_profile_c', required — The name of the verification profile.
    - `status` 'incomplete' | 'pending' | 'approved' | 'rejected' | 'resubmission_required', required — The status of the verification profile.
    - `criteria` object — The criteria for the verification profile.
      - `complete` string[], required — Completed fields.
      - `pending` string[], required — Pending fields. These fields are currently being verified.
      - `required` string[], required — Required fields. These fields are required to be completed before the verification profile can be approved.
      - `errors` object[], required — The errors that occurred while verifying the fields.
        - `name` 'email_verification' | 'phone_verification' | 'residential_address' | 'identity_document' | 'tax_identification_number' | 'liveness_check' | 'terms_of_service' | 'email_address' | 'phone_number' | 'master_service_agreement' | 'legal_name' | 'trade_name' | 'entity_type' | 'entity_type_description' | 'description' | 'registered_address' | 'operating_address' | 'business_representatives' | 'naics_code' | 'website' | 'incorporated_on' | 'identification_number' | 'registration_number' | 'estimated_annual_revenue' | 'expected_monthly_payments' | 'account_purpose' | 'account_purpose_description' | 'source_of_funds' | 'source_of_funds_description' | 'is_dao' | 'regulated_activities' | 'regulated_activities_description' | 'participates_in_regulated_financial_activity' | 'regulated_financial_activity_description' | 'money_services_description' | 'compliance_screening_explanation' | 'operates_in_prohibited_countries' | 'incorporation_cert_document' | 'incorporation_articles_document' | 'shareholder_registry_document' | 'proof_of_nature_of_business_document' | 'proof_of_address_document' | 'liveness_report_document' | 'ownership_percentage' | 'is_control_person' | 'is_signer' | 'relationship_established_at' | 'title' | 'sex' | 'country_of_birth' | 'nationality' | 'middle_name' | 'occupation_soc_code' | 'w8_ben_document' | 'w9_document' | 'w8_ben_e_document' | 'corporate_resolution_document' | 'source_of_funds_document' | 'financial_statements_document' | 'bank_statement_document' | 'regulated_activity_document' | 'flow_of_funds_document' | 'kyc_b_approval' | 'kyb_b_approval', required
        - `detail` string
  - `createdAt` string, required — The date and time the business representative was created.
  - `updatedAt` string, required — The date and time the business representative was last updated.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Unprocessable Entity - Validation Error

---

[API](https://skmtc.net/spherepay/apis/docs-spherepay-co.md) · [All operations](https://skmtc.net/spherepay/apis/docs-spherepay-co/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spherepay/docs-spherepay-co/versions/4f3f5484aed3/schema)