---
title: "Create"
method: POST
path: "/v2/report-configs"
tags: ["report-configs"]
---

# Create

`POST /v2/report-configs`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/report-configs`
- Auth: HTTP bearer

Create a Report Config

Create a new report configuration.
Only one config per report type per organization is allowed.

## Request body

- CreateReportConfigRequest: Request body for creating a report config.
  - `report_type` 'integration_sync_report' | 'ar_aging_report' | 'invoice_report' | 'customer_report' | 'payments_report' | 'credit_memo_report', required
  - `frequency` 'daily' | 'weekly' | 'monthly', required
  - `format` 'csv' | 'xlsx'
  - `time` string, time: Time of day (HH:MM) in org timezone. Minutes must be 0 or 30.
  - `weekday` integer: Day of the week (0=Monday, 6=Sunday). Only used by WEEKLY frequency.
  - `recipient_emails` string[]: Primary recipient email addresses
  - `cc_emails` string[], nullable: Optional CC email addresses (e.g., FDE team on failures)
  - `is_enabled` boolean, nullable
  - `notify_on_issues_only` boolean: If true, suppress the routine success email and only send when the sync had a failure or an expected entity synced zero records in the window. Only applies to INTEGRATION_SYNC_REPORT.

## Response `200`

Successful Response

- ReportConfig: Report configuration response.
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, nullable, required
  - `id` string, required
  - `report_type` 'integration_sync_report' | 'ar_aging_report' | 'invoice_report' | 'customer_report' | 'payments_report' | 'credit_memo_report', required
  - `is_enabled` boolean, required
  - `frequency` 'daily' | 'weekly' | 'monthly', required
  - `format` 'csv' | 'xlsx', required
  - `time` string, time, required: Time of day (HH:MM) in org timezone. Minutes must be 0 or 30.
  - `weekday` integer, required: Day of the week (0=Monday, 6=Sunday). Only used by WEEKLY frequency.
  - `recipient_emails` string[], required: Primary recipient email addresses
  - `cc_emails` string[], nullable, required: Optional CC email addresses (e.g., FDE team on failures)
  - `notify_on_issues_only` boolean, required: If true, suppress the routine success email and only send when the sync had a failure or an expected entity synced zero records in the window. Only applies to INTEGRATION_SYNC_REPORT.
  - `last_sent_at` string, date-time, nullable, required: UTC timestamp of the last successful report send
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/ff0ad16a55ff?raw)