# Store External Donations
source: https://developer.mastercard.com/donations/documentation/use-cases/record-api/index.md

## Overview {#overview}

This **Record API** is used to record all external donations in the Mastercard Donate service. Partners can share donation details with Mastercard Donate through this API. After the external donations are uploaded in Mastercard Donate, the partners can view them on the Mastercard Donate Insight portal.

## Sequence Diagram {#sequence-diagram}

The following outlines the sequence of events:
Diagram store-ext-donations

## Execution Steps {#execution-steps}

1. The partner provides all the partner, customer, merchant, and donation transaction details to Mastercard Donate to upload.
2. The Mastercard Donate service calls the `POST /donations/records` endpoint to upload the data.
3. The Mastercard Donate service confirms to the partner that all the external donation records are uploaded.

## Endpoint {#endpoint}


API Reference: `POST /records`

## Endpoint Parameter {#endpoint-parameter}

For more details on the endpoint parameters, refer to the [Parameters to Store External Donations](https://developer.mastercard.com/donations/documentation/parameters/records/index.md) section.

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

For more details, refer to the [Store External Donations](https://developer.mastercard.com/donations/tutorial/donation-api-details/recordapi/index.md) tutorial.