Company management

Create company

Property	Value
Endpoint	/company/create-company
Method	POST
Authorization	Bearer {token}

Request body

{
  "name": "Acme GmbH",
  "taxId": "DE123456789",
  "country": "DE",
  "city": "Berlin",
  "address": "Hauptstraße 1",
  "postalCode": "10115",
  "email": "billing@acme.de",
  "phoneNumber": "+493012345678"
}

Field	Type	Required	Description
name	String	Yes	Legal company name
taxId	String	Yes	VAT / Tax identification number
country	String	Yes	ISO 3166-1 alpha-2 (DE, FR)
city	String	Yes	City
address	String	Yes	Street address
postalCode	String	Yes	Postal code
email	String	Yes	Company contact email
phoneNumber	String	No	Phone number

Responses

Code	Description
200	Company created — returns companyId (UUID)
400	Validation error
409	Company with same tax ID already exists

Update company info

Property	Value
Endpoint	/company/info-update
Method	POST
Authorization	Bearer {token}

Request body — same fields as Create company, plus companyId.

Delete company

Property	Value
Endpoint	/company/delete/:companyId
Method	POST
Authorization	Bearer {token}

Path parameter: companyId — UUID of the company to delete.

{
  "feedback": "Customer offboarded"
}

Add user to company

Property	Value
Endpoint	/company/add-user
Method	POST
Authorization	Bearer {token}

{
  "companyId": "uuid",
  "userId": "uuid"
}

Update user authorities

Property	Value
Endpoint	/company/update-user-auths
Method	POST
Authorization	Bearer {token}

Set default Peppol participant

Property	Value
Endpoint	/company/:companyId/default-participant/:participantId
Method	PUT
Authorization	Bearer {token}