Skip to main content

​
Endpoint

POST /clients/business

​
Headers

​
Authorization
string
required
Bearer YOUR_ACCESS_TOKEN
​
SECRET_KEY
string
required
Your API secret key.

​
Request body

​
businessName
string
required
The legal name of the business.
​
countryId
string
required
The ID of the country where the business is registered.
​
isNewBusiness
boolean
required
Set to true if this is a newly registered business, false if it is an existing one.

​
Response

​
status
boolean
true on success.
​
message
string
Human-readable outcome.
​
data.business.id
string
The unique ID of the newly created business. Save this — you will use it as your businessId header on subsequent requests.
​
data.business.businessName
string
The name of the business as registered.

​
Code examples

curl -X POST https://sandbox.stellasbank.com/api/v1/clients/business \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "SECRET_KEY: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "businessName": "Acme Ltd",
    "countryId": "NG",
    "isNewBusiness": true
  }'

​
Example response

{
  "status": true,
  "message": "Business created successfully",
  "data": {
    "business": {
      "id": "biz_xyz789",
      "businessName": "Acme Ltd"
    }
  }
}