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