Skip to main content
POST
/
v1
/
platform
/
businesses
Create
curl --request POST \
  --url https://api.cadanapay.com/v1/platform/businesses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessName": "Wayne Enterprise",
  "adminFirstName": "Jane",
  "adminLastName": "Founder",
  "address": {
    "countryCode": "US",
    "line1": "Street 1",
    "line2": "Apt 1",
    "city": "Gotham",
    "postalCode": "10001",
    "state": "NY"
  },
  "adminEmail": "admin@example.com",
  "idempotencyKey": "b6ae5da9-6342-4a58-bd50-8564d68d3f7e",
  "country": "US",
  "businessShortName": "W.E.",
  "suppressWelcomeEmail": false,
  "registrationId": "991234567",
  "adminPhoneNumber": {
    "countryCode": "1",
    "number": "2345678901"
  }
}
'
{
  "businessId": "8ef9a712-cdae-4110-b1ea-9ba95abbee6e",
  "tenantKey": "biz123456"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create business request payload

​
businessName
string
required

Business name

Example:

"Wayne Enterprise"

​
adminFirstName
string
required

First name of the admin of the business

Example:

"Jane"

​
adminLastName
string
required

Last name of the admin of the business

Example:

"Founder"

​
address
object
required

Address

​
adminEmail
string
required

Person's email

Example:

"admin@example.com"

​
idempotencyKey
string
required

Unique string to prevent dedupe

Example:

"b6ae5da9-6342-4a58-bd50-8564d68d3f7e"

​
country
string
required
Example:

"US"

​
businessShortName
string

Shortname of the business

Example:

"W.E."

​
suppressWelcomeEmail
boolean
default:false

Whether you want to suppress the welcome email

​
registrationId
string

Registration id/number of the business

Example:

"991234567"

​
adminPhoneNumber
object

Person's phone number

Response

get user kyc response

​
businessId
string<uuid>
Example:

"8ef9a712-cdae-4110-b1ea-9ba95abbee6e"

​
tenantKey
string
Example:

"biz123456"