---
title: "Create a report"
method: POST
path: "/reports"
tags: ["reports"]
---

# Create a report

`POST /reports`

## Request

- Base URL: `https://api.lumahealth.io/api/v2`
- URL: `https://api.lumahealth.io/api/v2/reports`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lumahealth/apis/rest-service/docs/reports/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- ReportRequestCreate
  - `_id` string, uuid, required
  - `name` string, required
  - `description` string, required
  - `enabled` boolean, required
  - `type` string, required

## Response `201`

Successful creation

- ReportResponse: Represents a configured analytics report or dashboard, backed by Looker or Sigma, that staff can view within Luma Health. It stores the report name, description, external dashboard reference, and whether it is a custom, featured, or legacy report type.
  - `_id` string, uuid
  - `name` string
  - `description` string
  - `enabled` boolean
  - `type` string

## Other responses

- `401`: Not authenticated
- `403`: Access token does not have the required scope
- `default`: Unexpected error

---

[API](https://skmtc.dev/lumahealth/apis/rest-service.md) - [All operations](https://skmtc.dev/lumahealth/apis/rest-service/llms.txt) - [OpenAPI document](https://skmtc.dev/lumahealth/apis/rest-service/revisions/f19aeba84a26?raw)