Skip to main content
POST
https://api-dev-embedded.embedly.ng
/
embedded
/
api
/
v1
/
create-business
Create Business
curl --request POST \
  --url https://api-dev-embedded.embedly.ng/embedded/api/v1/create-business \
  --header 'Content-Type: application/json' \
  --data '
{
  "orgId": "<string>",
  "title": "<string>",
  "firstName": "<string>",
  "lastName": "<string>",
  "dateOfBirth": "<string>",
  "businessName": "<string>",
  "email": "<string>",
  "phoneNumber": "<string>",
  "industry": "<string>",
  "country": "<string>",
  "lga": "<string>",
  "streetAddress": "<string>",
  "state": "<string>",
  "bvn": "<string>",
  "nin": "<string>",
  "businessType": "<string>",
  "businessRegistrationNumber": "<string>",
  "taxIdentificationNumber": "<string>",
  "dateOfIncorporation": "<string>",
  "bankCode": "<string>",
  "accountName": "<string>",
  "accountNumber": "<string>",
  "postalCode": "<string>",
  "webhook": "<string>",
  "webhookSecret": "<string>"
}
'
{
	"data": {
		"businessCreated": true,
		"businessId": "32c1a8f6-cbda-4d35-929f-99ccec85d9c8"
	},
	"statusCode": 200,
	"message": "Business created successfully!"
}

​
Create Business

​
orgId
string
required
Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
​
title
string
required
Contact person’s title, Example: Mr
​
firstName
string
required
Contact person’s first name, Example: John
​
lastName
string
required
Contact person’s last name, Example: Mark
​
dateOfBirth
string
required
Contact person’s date of birth in YYYY-MM-DD format. Example: 2025-03-21
​
businessName
string
required
Business’ legal name, Example: Embedded Finance
​
email
string
required
The business’ email. Example: [email protected]
​
phoneNumber
string
required
The business’ phone number, Example: “
​
industry
string
required
​
country
string
required
​
lga
string
required
​
streetAddress
string
required
​
state
string
required
​
bvn
string
required
​
nin
string
required
​
businessType
string
required
Example: Sole Proprietorship
​
businessRegistrationNumber
string
required
​
taxIdentificationNumber
string
required
​
dateOfIncorporation
string
required
Example: 2025-03-21
​
bankCode
string
required
​
accountName
string
required
​
accountNumber
string
required
​
postalCode
string
required
​
webhook
string
required
​
webhookSecret
string
required
{
	"data": {
		"businessCreated": true,
		"businessId": "32c1a8f6-cbda-4d35-929f-99ccec85d9c8"
	},
	"statusCode": 200,
	"message": "Business created successfully!"
}