---
title: "This endpoint is for requesting to add new TOEs (targets of evaluation) to your portfolio."
method: POST
path: "/v1/portfolio/bulk_add"
tags: ["Portfolio"]
---

# This endpoint is for requesting to add new TOEs (targets of evaluation) to your portfolio.

`POST /v1/portfolio/bulk_add`

This is a bulk request for requesting to add new TOEs (targets of evaluation) to your portfolio.
The request must have at least one item but no more than 25 per request.

## Request body

- CreateTOEs — A collection of CustomerToeRequest request objects.
  - `customer_toe_requests` CreateTOE[]
    - `subscription_level` '1' | '2' — The SubscriptionLevelConfig must be 1 (Discover) or 2 (Advisor). Either this or a subscription level config are required.
    - `internal_name` string[], nullable — The user defined names for the TOE.
    - `internal_id` string[], nullable — The user defined identifiers for the TOE. These can be used to query the TOE.
    - `company_name` string, required — The Name of the Company. This is required.
    - `company_domains` string[], required — An array of domains. There must include at least one.
    - `assessment_frequency` 'one_time' | 'continuous', required — The Scan frequency. This is required and must be either one_time or continuous.
    - `risk_relationship_slugs` string[] — Risk relationship slugs which are returned from /v1/portfolio/risk_relationships_folders. This is optional.

## Response `200`

OK

## Other responses

- `400` — Something was wrong with the request
- `401` — Authentication information was missing or invalid or the user is not authorized to access resource or perform the associated action.

---

[API](https://skmtc.dev/recordedfuture/apis/alert-api.md) · [All operations](https://skmtc.dev/recordedfuture/apis/alert-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recordedfuture/alert-api/revisions/c8c2f68d8b60/schema)