---
title: "Create a Metric"
method: POST
path: "/metrics"
tags: ["Metrics"]
---

# Create a Metric

`POST /metrics`

Create a new metric for a company.

## Request body

- object
  - `metric` MetricInput
    - `name` string, required — Name of the metric
    - `frequency` 'daily' | 'weekly' | 'monthly' | 'quarterly', required — Frequency of the metric reporting
    - `unit` string, required — Unit of measurement (number, percent, or ISO4217 currency code)
    - `company_id` string, uuid, required — ID of the company or fund

## Response `201`

Metric successfully created

- object
  - `metric` Metric
    - `id` string, uuid, required — Unique identifier for the metric
    - `name` string, required — Name of the metric
    - `frequency` 'daily' | 'weekly' | 'monthly' | 'quarterly', required — Frequency of the metric reporting
    - `unit` string, required — Unit of measurement (number, percent, or ISO4217 currency code)
    - `portfolio_company_profile_id` string, uuid, nullable — ID of the associated portfolio company profile
    - `company_id` string, uuid, required — ID of the company or fund
    - `created_at` string, date-time — When the metric was created

## Other responses

- `400` — Bad Request - The request is invalid or malformed
- `401` — Unauthorized - Invalid or missing authentication token
- `422` — Unprocessable Entity - The request is valid but contains semantic errors
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/visible/apis/visible-api.md) · [All operations](https://skmtc.dev/visible/apis/visible-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/visible/visible-api/revisions/a04e0975020f/schema)