Skip to main content
POST
/
companies
Create company
curl --request POST \
  --url https://client-api.dev.finhost.io/companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "position": "<string>",
  "email": "[email protected]",
  "registrationNumber": "<string>",
  "contactName": "<string>",
  "tradingAddress": {
    "country": "<string>",
    "postCode": "<string>",
    "state": "<string>",
    "street": "<string>",
    "streetLine2": "<string>",
    "town": "<string>"
  },
  "phone": "+38090903"
}
'
{
  "companyType": "<string>",
  "companyId": "<string>",
  "kyc": "<string>",
  "adm": "<string>",
  "id": "<string>",
  "name": "<string>",
  "position": "<string>",
  "email": "[email protected]"
}

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required
type
string
required
position
string
required
email
string
required
registrationNumber
string
required
contactName
string
required
tradingAddress
object
required
phone
string
Example:

"+38090903"

Response

200 - application/json

200 response

companyType
string

Type of the company

companyId
string

Unique identifier of the company

kyc
string

Status of the KYC process

adm
string

Status of the ADM process

id
string

Unique identifier of the company profile

name
string

Name of the company

position
string

Position of the user within the company

email
string<email>

Company email