POST
/
individual-customers
curl --request POST \
  --url https://api-staging.stablestack.xyz/api/individual-customers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "customer_type": "individual",
  "first_name": "John",
  "middle_name": "Oluwaseun",
  "last_name": "Ola",
  "email": "olajohn3@gmail.com",
  "phone": "+2348918945668",
  "birth_date": "1990-01-15",
  "account_purpose": "personal savings",
  "employment_status": "employed",
  "expected_monthly_income": 500000,
  "most_recent_occupation": "Software Engineer",
  "source_of_funds": "salary",
  "address": {
    "line_1": "123 Main St",
    "line_2": "Suite 456",
    "city": "Lagos",
    "state": "Lagos",
    "postal_code": "214578",
    "country": "Nigeria"
  }
}'
{
  "status": "success",
  "data": {
    "id": "11a3c37f-06bb-4e7c-9813-0e47d47e9e2d",
    "customer_type": "individual",
    "email": "olajohn3@gmail.com",
    "phone": "+2348918945668",
    "created_at": "2025-05-09T16:33:57.844Z",
    "updated_at": "2025-05-09T16:33:57.844Z",
    "status": "active",
    "address": {
      "line_1": "123 Main St",
      "line_2": "Suite 456",
      "city": "Lagos",
      "state": "Lagos",
      "postal_code": "214578",
      "country": "Nigeria"
    },
    "personal_info": {
      "first_name": "john",
      "middle_name": "Oluwaseun",
      "last_name": "ola",
      "birth_date": "1990-01-14T23:00:00.000Z"
    },
    "financial_info": {
      "account_purpose": "personal savings",
      "employment_status": "employed",
      "expected_monthly_income": "500000.00",
      "most_recent_occupation": "Software Engineer",
      "source_of_funds": "salary"
    }
  }
}

Creates a new individual customer account.

Key Features:

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

Request Body:

{
  "customer_type": "individual",
  "first_name": "john",
  "middle_name": "Oluwaseun",
  "last_name": "ola",
  "email": "olajohn3@gmail.com",
  "phone": "+2348918945668",
  "birth_date": "1990-01-15",
  "account_purpose": "personal savings",
  "employment_status": "employed",
  "expected_monthly_income": 500000,
  "most_recent_occupation": "Software Engineer",
  "source_of_funds": "salary",
  "address": {
    "line_1": "123 Main St",
    "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 individual customer account

The body is of type object.

Response

201 - application/json

Created

The response is of type object.