# Add TOEs in Bulk to your Portfolio
source: https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/add-bulk-toes/index.md

## Overview {#overview}

The `POST Bulk Add` endpoint adds both [new and existing TOEs](https://developer.mastercard.com/riskrecon-api/documentation/glossary/index.md#toe) in bulk to your portfolio. Although you can use this endpoint to add existing TOEs, the recommended use is to add new TOEs that RiskRecon does not currently monitor and needs to be created by a security analyst. You can add TOEs through this endpoint for only the Advisor and Discover licenses or subscriptions.

You can request to add a maximum of 25 TOEs at a time through the request body using this endpoint. The TOE details could include information such as, risk relationship slug, company name and domain, assessment frequency, internal names and ID, and subscription level.

If you have already set the subscription level, you can skip this parameter in the request body of this endpoint. For more details on how to set subscription levels, refer to the [Set Subscription Level Configuration](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/set-deflt-subsn-lev-config/index.md) use case.

The turnaround time for adding TOEs is a few business days and involves several processes, such as raising a request ticket with the RiskRecon customer care, analysis and creation of TOEs by a security analyst, and detecting existing TOEs.

You can also add existing TOEs instantly using the `POST TOE` endpoint. For more details on the `POST TOE` endpoint, refer to the [Add an Existing TOE to your Portfolio](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/add-an-existing-toe/index.md) use case.

## Sequence Diagram {#sequence-diagram}

The following diagram shows how to add TOEs in bulk to your portfolio:
Diagram add-toes

## Execution Steps {#execution-steps}

The following steps show how to add TOEs in bulk to your portfolio:

1. The user sends a `POST` request to add TOEs in bulk to the portfolio. Note: If you have set the default subscription level configuration using the `PUT Subscription Level Config` endpoint, you can exclude the `Subscription Level` parameter in the request body of this endpoint. For more details on the `PUT Subscription Level Config` endpoint, refer to the [Set the Default Subscription-Level Configuration](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/set-deflt-subsn-lev-config/index.md) use case.
2. RiskRecon adds the requested TOEs to the user's portfolio.

## Sample Request and Response {#sample-request-and-response}

For a sample request and response of this API, see [Post TOEs in Bulk to your Portfolio](https://developer.mastercard.com/riskrecon-api/documentation/testing/portfolio-samples/add-bulk-toes-smpl/index.md).

## Use Case Examples {#use-case-examples}

The use cases in this section discuss how you can use the `POST Bulk Add` endpoint to add TOEs in bulk to your portfolio:

* [Add new TOEs for evaluation and analysis](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/add-bulk-toes/index.md#add-new-toes-for-evaluation-and-analysis)
* [Add TOEs not being currently evaluated by RiskRecon](https://developer.mastercard.com/riskrecon-api/documentation/use-cases/portfolio-management/portfolio/add-bulk-toes/index.md#add-toes-not-being-currently-evaluated-by-riskrecon)

### Add new TOEs for evaluation and analysis {#add-new-toes-for-evaluation-and-analysis}

A RiskRecon customer is evaluating 15 new vendors to expand their supply chain and wants to add TOEs in bulk to their portfolio. Using this endpoint, the customer can request to add all 15 TOEs to its portfolio for further analysis.

### Add TOEs not being currently evaluated by RiskRecon {#add-toes-not-being-currently-evaluated-by-riskrecon}

A RiskRecon customer has 20 vendors that are not being currently evaluated by RiskRecon. The customer wants RiskRecon to analyze these vendors to know if they are maintaining a healthy cyber-security environment and can use this endpoint to request a security analyst to create the TOEs for the vendors and add all the TOEs to their portfolio.

## Endpoint {#endpoint}


API Reference: `POST /v1/portfolio/bulk_add`