---
title: "Create a new report."
method: POST
path: "/cm/v1/reports"
tags: ["Report"]
---

# Create a new report.

`POST /cm/v1/reports`

Create a new report of a specific AdAccount.

## Query parameters

- `ad_account_id` string, required

## Request body

- DspReport — The metadata of a report.
  - `id` string — Unique identifier of the Report. Automatically set by server on creation.
  - `ad_account_id` string, required — Ad account ID to which the report associated.
  - `product_id` string — Product App or Site ID to which the report associated.
  - `date_range` AdcloudcommonDateInterval, required — Interval with start and end dates in the format of YYYY-MM-DD.
    - `start` string — Start date in the format of YYYY-MM-DD.
    - `end` string — End date in the format of YYYY-MM-DD.
  - `dimensions` DspReportDimension[], required — List of interested dimensions by which metric numbers will be broken down.
  - `optional_metrics` ReportOptionalMetric[] — List of interested optional metrics.
  - `expire_at` string, date-time — The time when a report will be expired.
  - `created_at` string, date-time — Created time.
  - `updated_at` string, date-time — Last updated time. Should not modify on the client side.

## Response `200`

A successful response.

- MessagesCreateReportResponse
  - `id` string — Unique ID of the newly created report.
  - `href` string — Reference URL that shows the report.
  - `status` string — Reference URL that shows the most recent status of the report.

## Other responses

- `default` — Error. Detailed cause can be found in the `details` field.

---

[API](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api.md) · [All operations](https://skmtc.net/moloco/apis/moloco-ads-campaign-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moloco/moloco-ads-campaign-management-api/revisions/5c85d0910ac0/schema)