Skip to main content
POST
/
api
/
v1
/
companies
cURL
curl -sS -X POST "$FLUIDE_BASE_URL/api/v1/companies" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "success": true,
  "message": "Operation completed successfully",
  "data": {}
}

Body

application/json
​
name
string
required

Legal or display company name.

Example:

"Fluide SARL"

​
countryCode
string
required

ISO 3166-1 alpha-2 country code.

Example:

"CM"

​
currency
string
required

Primary company currency using ISO 4217 code.

Example:

"XAF"

​
businessCreatedAt
string
required

Business legal creation/incorporation date.

Example:

"2021-04-12"

​
businessSize
string
required

Business size bucket.

Minimum string length: 1
Example:

"11-50"

​
organizationStructure
object
required

Organization structure details.

​
paydays
object
required

Configured payday(s).

​
bankConnection
object
required

Bank account details used for payroll funding.

​
mobileMoneyWallet
object
required

Mobile money wallet details.

​
signatures
object
required

Signature assets for approvals and generated documents.

​
payrollSetup
object
required

Payroll setup details including groups, allowances and deductions.

​
employeeNumberFormat
object
required

Employee number generation format.

​
notificationSettings
object
required

Notification channel preferences.

​
registrationNumber
string

Official company registration number.

Minimum string length: 1
Example:

"RC-123456"

​
taxId
string

Tax identifier (e.g. NIU).

Example:

"NIU-7890"

​
address
string

Registered business address.

Minimum string length: 1
Example:

"Bonanjo, Douala"

​
city
string

Business city.

Example:

"Douala"

Public URL for company logo.

Minimum string length: 1
Example:

"https://cdn.fluide.com/company/logo.png"

​
industryCategory
string

Industry category.

Minimum string length: 1
Example:

"Technology"

Response

Create — created

​
success
boolean
required

Whether the request succeeded

Example:

true

​
message
string
required

Human-readable outcome message (localized when i18n is configured)

Example:

"Operation completed successfully"

​
data
object

Endpoint-specific payload