# Create a report email subscription

**POST** `/report-email-subscriptions`

Base URL: `https://api.uat.triple-a.io/api/fiat-payout/v1`

This endpoint allows you to subscribe to receive a scheduled report by email. Idempotent - subscribing to an existing (report_type, frequency) returns the existing subscription.

## Authorization

- oauth2 (http, bearer)

## Body

Content type: `application/json`

- `report_type` ("fp_account_statement", required)
  Report type. Allowed values: fp_account_statement.
- `frequency` ("daily" | "monthly", required)
  Schedule cadence.

Example:

```json
{
  "report_type": "fp_account_statement",
  "frequency": "daily"
}
```

## Responses

### 201

Created

- `id` (string<uuid>)
- `report_type` ("fp_account_statement")
- `frequency` ("daily" | "monthly")
- `created_at` (string<date-time>)
- `updated_at` (string<date-time>)

Example:

```json
{
  "id": "00000000-0000-0000-0000-000000000000",
  "report_type": {},
  "frequency": {},
  "created_at": "1970-01-01T00:00:00.000Z",
  "updated_at": "1970-01-01T00:00:00.000Z"
}
```

### 400

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```

### 500

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```