# Add Company To Portfolio

Endpoint to add a company using a company id, into a portfolio provided in as a path parameter. Additional fields can be used to add a personalReference, freeText, and personalLimit. These fields need to be submitted in the requestBody but can be 'nulled' if not required. See the two examples of the submission with and without these fields.

Endpoint: POST /monitoring/portfolios/{portfolioId}/companies
Version: 1.10.9
Security: bearerToken

## Path parameters:

  - `portfolioId` (number, required)
    The unique identifier of the portfolio, obtained from .

## Request fields (application/json):

  - `id` (string, required)
    The company Safe Number or Connect ID

  - `personalReference` (string,null, required)
    A personal reference for the company

  - `freeText` (string,null, required)
    A free field to add any additional text to the company in the portfolio

  - `personalLimit` (string,null, required)
    A personal limit for the company - separate from the credit limit

## Response 200 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.
    Example: "23921650-c073-11ea-860f-06bc8182190e"

  - `message` (string)
    A status message relating to your request.
    Example: "Company Added"

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Access forbidden"

## Response 404 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 409 fields (application/json):

  - `correlationId` (string)
    The unique identifier. (A UUID specified by RFC4122).

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected