Customers
Create Individual
API reference for creating individual customer accounts
POST
/
individual-customers
Copy
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"
}
}'
Copy
{
"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:
Copy
{
"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
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
.
Copy
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"
}
}'
Copy
{
"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"
}
}
}
Assistant
Responses are generated using AI and may contain mistakes.