# Create Monitoring Portfolio

This endpoint to create a new Portfolio based on the supplied criteria. A portfolio can contain any number of companies that you wish to monitor changes to. The only required Body parameter is "name" for Connect users.

Endpoint: POST /monitoring/portfolios
Version: 1.10.9
Security: bearerToken

## Request fields (application/json):

  - `name` (string, required)
    The name of the portfolio
    Example: "Test Portfolio"

  - `isDefault` (boolean)
    can set the portfolio as default for company monitoring events.

  - `emails` (array)
    The email address of the user to receive the email notification.

  - `emails.firstName` (string)
    The first name of the user to receive the email notification.
    Example: "John"

  - `emails.lastName` (string)
    The last name of the user to receive the email notification.
    Example: "Doe"

  - `emails.emailAddress` (string)
    The email address of the user to receive the email notification.
    Example: "john.doe@creditsafe.com"

  - `emailSubject` (string)
    The subject of the email notification.
    Example: "Creditsafe Monitoring Notification on portfolio {{portfolioName}}"

  - `emailLanguage` (string)
    The language of the email notification.
    Example: "en"

  - `frequency` (string)

## Response 200 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.
    Example: "14cc64a0-c108-11ea-b9af-06bcc69a383e"

  - `portfolioId` (number)
    A unique ID assigned to each portfolio.
    Example: 131318

  - `name` (string)
    The name that was assigned to this portfolio
    Example: "My New Portfolio"

  - `isDefault` (boolean)
    Shows if the portfolio is set as Default for the user.

## 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