New: Streamlined onboarding defaults  View changelog →
Business Representative

Create a Business Representative

Create a new business representative for a customer.

POST
/v2/business-representative

Authorization

AuthorizationBearer <token>

In: header

Request Body

customerIdstring

The ID of the business customer this representative belongs to.

Length1 <= length
typestring

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

Value in"individual"
emailstring

The email address of the business representative.

Formatemail
Lengthlength <= 254
phonestring

The phone number of the business representative.

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

The address of the business representative.

personalInformationobject

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.

representationDetailsobject

The representation details of the business representative.

Response Body

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"
    }
  ]
}