---
title: "POST /user/{userID}/company"
method: POST
path: "/user/{userID}/company"
tags: ["company"]
---

# POST /user/{userID}/company

`POST /user/{userID}/company`

Create and manage companies.

## Path parameters

- `userID` integer, required

## Headers

- `Cache-Control` string
- `User-Agent` string, required
- `X-Bunq-Language` string
- `X-Bunq-Region` string
- `X-Bunq-Client-Request-Id` string
- `X-Bunq-Geolocation` string
- `X-Bunq-Client-Authentication` string, required

## Request body

- Company
  - `name` string, required — The company name.
  - `address_main` Address, required
    - `street` string — The street.
    - `house_number` string — The house number.
    - `po_box` string — The PO box.
    - `postal_code` string — The postal code.
    - `city` string — The city.
    - `country` string — The country as an ISO 3166-1 alpha-2 country code.
    - `extra` string — The apartment, building or other extra information for addresses.
    - `mailbox_name` string — The name on the mailbox (only used for Postal and Shipping addresses).
    - `province` string — The province according to local standard.
    - `is_user_address_updated` boolean — To show whether user created or updated her address for app event listing.
  - `address_postal` Address, required
    - `street` string — The street.
    - `house_number` string — The house number.
    - `po_box` string — The PO box.
    - `postal_code` string — The postal code.
    - `city` string — The city.
    - `country` string — The country as an ISO 3166-1 alpha-2 country code.
    - `extra` string — The apartment, building or other extra information for addresses.
    - `mailbox_name` string — The name on the mailbox (only used for Postal and Shipping addresses).
    - `province` string — The province according to local standard.
    - `is_user_address_updated` boolean — To show whether user created or updated her address for app event listing.
  - `country` string, required — The country where the company is registered.
  - `ubo` Ubo[] — The names and birth dates of the company's ultimate beneficiary owners. Minimum zero, maximum four.
    - `name` string — The name of the ultimate beneficiary owner.
    - `date_of_birth` string — The date of birth of the ultimate beneficiary owner.
    - `nationality` string — The nationality of the ultimate beneficiary owner.
  - `chamber_of_commerce_number` string — The company's chamber of commerce number.
  - `legal_form` string, required — The company's legal form.
  - `subscription_type` string, required — The subscription type for the company.
  - `avatar_uuid` string — The public UUID of the company's avatar.
  - `vat_number` CompanyVatNumber
    - `type` string — The VAT identification number type.
    - `country` string — The country of the VAT identification number.
    - `value` string — The VAT identification number number.
  - `vat_numbers` CompanyVatNumber[] — All the vat numbers of the company
    - `type` string — The VAT identification number type.
    - `country` string — The country of the VAT identification number.
    - `value` string — The VAT identification number number.
  - `signup_track_type` string — The type of signup track the user is following.

## Response `200`

Create and manage companies.

- CompanyCreate
  - `Id` BunqId
    - `id` integer — An integer ID of an object. Unique per object type.

## Other responses

- `400` — This is how the error response looks like for 4XX response codes

---

[API](https://skmtc.net/bunq/apis/bunq-api.md) · [All operations](https://skmtc.net/bunq/apis/bunq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bunq/bunq-api/revisions/369477c7bd26/schema)