Create a Business Representative

Authorization

bearer

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

customerId*string

The ID of the business customer this representative belongs to.

Length1 <= length

type*string

The type of the business representative. Must be "individual".

Value in"individual"

email*string

The email address of the business representative.

Formatemail

Lengthlength <= 254

phone*string

The phone number of the business representative.

Match^\+(?:[0-9]){6,14}[0-9]$

address*

The address of the business representative.

personalInformation*

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 for the full list of reference.

representationDetails*

The representation details of the business representative.

Response Body

`application/json`

curl -X POST "https://api.spherepay.co/v2/business-representative" \  -H "Content-Type: application/json" \  -d '{    "customerId": "customer_2f283221a9d44ada800ac7f11f640402",    "type": "individual",    "email": "james.wilson@acmecorp.example.com",    "phone": "+13125559876",    "address": {      "line1": "233 South Wacker Drive",      "city": "Chicago",      "country": "USA"    },    "personalInformation": {      "taxIdentificationNumber": "123456789",      "taxIdentificationNumberType": "ssn",      "taxIdentificationNumberCountry": "USA"    },    "representationDetails": {      "roles": [        "ubo"      ],      "ownershipPercentage": "50",      "isControlPerson": true,      "isSigner": true,      "relationshipEstablishedAt": "2020-03-15",      "title": "CEO"    }  }'

{
  "id": "associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b",
  "customerId": "customer_2f283221a9d44ada800ac7f11f640402",
  "type": "individual",
  "email": "james.wilson@acmecorp.example.com",
  "phone": "+13125559876",
  "representationDetails": {
    "roles": [
      "ubo"
    ],
    "ownershipPercentage": "50",
    "isControlPerson": true,
    "isSigner": true,
    "relationshipEstablishedAt": "2020-03-15",
    "title": "CEO"
  },
  "verificationProfiles": [
    {
      "name": "ubo_kyc_profile_a",
      "status": "incomplete",
      "criteria": {
        "complete": [
          "email_address",
          "phone_number",
          "residential_address",
          "tax_identification_number",
          "ownership_percentage",
          "is_control_person",
          "is_signer",
          "relationship_established_at",
          "title"
        ],
        "pending": [],
        "required": [
          "identity_document",
          "liveness_report_document",
          "proof_of_address_document"
        ],
        "errors": []
      }
    }
  ],
  "createdAt": "2026-03-10T00:00:08.986Z",
  "updatedAt": "2026-03-10T00:00:08.986Z"
}

{
  "status": 400,
  "detail": "Invalid request parameters",
  "code": "address/invalid",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 404,
  "detail": "Resource not found",
  "code": "resource/not-found",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 422,
  "detail": "Validation failed",
  "code": "validation/failed",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
  "errors": [
    {
      "detail": "Invalid email format",
      "pointer": "/email"
    },
    {
      "detail": "Name is required",
      "pointer": "/name"
    }
  ]
}

Create a Business Representative

Authorization

Request Body

Response Body

201application/json

400application/json

404application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`