Skip to main content
POST
/
corporate
/
customers
Create Corporate Customer
curl --request POST \
  --url https://waas-staging.embedly.ng/api/v1/corporate/customers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "rcNumber": "<string>",
  "tin": "<string>",
  "fullBusinessName": "<string>",
  "businessAddress": "<string>",
  "countryId": "<string>",
  "city": "<string>",
  "email": "<string>",
  "walletPreferredName": "<string>"
}
'
{
  "code": "00",
  "success": true,
  "message": "Created Successfully",
  "data": {
    "id": "724bb798-fae8-4856-97a6-9d2076266c29",
    "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
    "customerTypeId": "0ed8b99b-8097-4e49-bd4c-ff0410c57d27",
    "countryId": "c15ad9ae-c4d7-4342-b70f-de5508627e3b",
    "city": "Lagos",
    "address": "12 Adeola Odeku Street, Victoria Island, Lagos",
    "emailAddress": "[email protected]",
    "corporateName": "Acme Technologies Limited",
    "isCorporateVerified": "Pending",
    "dateCreated": "2025-12-08T06:25:48.5611027Z"
  }
}

Request Parameters

rcNumber
string
required
The RC number of the business. Example: 123456
tin
string
required
The Tax Identification Number (TIN) of the business. Example: 01234567-0001
fullBusinessName
string
required
The registered full business name. Example: Acme Technologies Limited
businessAddress
string
required
The physical address of the business. Example: 12 Adeola Odeku Street, Victoria Island, Lagos
countryId
string
required
The unique identifier of the country. Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
city
string
required
The city where the business is located. Example: Lagos
email
string
required
The official business email address. Example: [email protected]
walletPreferredName
string
required
The preferred display name for the business wallet. Example: AcmeWallet
{
  "code": "00",
  "success": true,
  "message": "Created Successfully",
  "data": {
    "id": "724bb798-fae8-4856-97a6-9d2076266c29",
    "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
    "customerTypeId": "0ed8b99b-8097-4e49-bd4c-ff0410c57d27",
    "countryId": "c15ad9ae-c4d7-4342-b70f-de5508627e3b",
    "city": "Lagos",
    "address": "12 Adeola Odeku Street, Victoria Island, Lagos",
    "emailAddress": "[email protected]",
    "corporateName": "Acme Technologies Limited",
    "isCorporateVerified": "Pending",
    "dateCreated": "2025-12-08T06:25:48.5611027Z"
  }
}