POST
/
business-customers
curl --request POST \
  --url https://api-staging.stablestack.xyz/api/business-customers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "customer_type": "business",
  "business_name": "Example Enterprises",
  "business_type": "Retail",
  "business_website": "https://example.com",
  "email": "contact@example.com",
  "phone": "+2347918945668",
  "account_purpose": "business operations",
  "source_of_funds": "business revenue",
  "expected_monthly_income": 5000000,
  "address": {
    "line_1": "123 Main St",
    "line_2": "Suite 456",
    "city": "Lagos",
    "state": "Lagos",
    "postal_code": "214578",
    "country": "Nigeria"
  }
}'
{
  "status": "success",
  "data": {
    "id": "e927caad-9576-40d8-b87d-ace687afa82a",
    "customer_type": "business",
    "email": "contact@example.com",
    "phone": "+2347918945668",
    "created_at": "2025-05-09T16:33:21.902Z",
    "updated_at": "2025-05-09T16:33:21.902Z",
    "status": "active",
    "address": {
      "line_1": "123 Main St",
      "line_2": "Suite 456",
      "city": "Lagos",
      "state": "Lagos",
      "postal_code": "214578",
      "country": "Nigeria"
    },
    "financial_info": {
      "account_purpose": "business operations",
      "expected_monthly_income": "5000000.00",
      "source_of_funds": "business revenue"
    },
    "business_info": {
      "business_name": "Example Enterprises",
      "business_type": "Retail",
      "business_website": "https://example.com"
    }
  }
}

Creates a new business customer account.

Key Features:

  • Comprehensive business information collection
  • Business-specific validation rules
  • Email and phone uniqueness validation
  • Returns complete business profile with financial info

Request Body:

{
  "customer_type": "business",
  "business_name": "Akande Enterprises",
  "business_type": "Retail",
  "business_website": "https://akandeyu.com",
  "email": "contact@akandeyu.com",
  "phone": "+2347918905668",
  "account_purpose": "Business operations",
  "source_of_funds": "business revenue",
  "expected_monthly_income": 5000000,
  "address": {
    "line_1": "123 Business Ave",
    "line_2": "Suite 456",
    "city": "Lagos",
    "state": "Lagos",
    "country": "Nigeria",
    "postal_code": "214578"
  }
}

Headers

x-api-key
string
required

Body

application/json

Create a new business customer account

The body is of type object.

Response

201 - application/json

Created

The response is of type object.