---
title: "Create a parameter"
method: POST
path: "/parameters"
tags: ["Parameters"]
---

# Create a parameter

`POST /parameters`

## Request

- Base URL: `https://connect-au.catapultsports.com/api/v6`
- URL: `https://connect-au.catapultsports.com/api/v6/parameters`
- Auth: HTTP bearer

Create a parameter. Currently all parameters are created with the "Custom" parameter type.

## Request body

- object
  - `name` string, required
  - `calculation` string, required: Equation that defines how this parameter will be calculated
  - `unit_type` '' | 'count' | 'distance' | 'duration' | 'percentage' | 'speed' | 'weight', required: The type of units that will be used to display this parameter. Empty string indicates arbitrary units, for example player load.
  - `ctr_order` number: Position of this parameter in CTR report

## Response `200`

Newly created parameter

- object
  - `id` string, uuid, required
  - `parameter_type_id` string, uuid, required
  - `name` string, required
  - `original_name` string, required
  - `base_name` string
  - `band` number, nullable
  - `aggregation` string
  - `group_by` string
  - `slug` string, required
  - `unit_type` '' | 'count' | 'distance' | 'duration' | 'percentage' | 'speed' | 'weight': The type of units that will be used to display this parameter. Empty string indicates arbitrary units, for example player load.
  - `calculation` string: Equation that defines how this parameter will be calculated
  - `ctr_order` number, required: Position of this parameter in CTR report
  - `created_at` string, required
  - `modified_at` string, required

## Other responses

- `401`: Unauthorized
- `422`: Invalid parameter attributes

---

[API](https://skmtc.dev/catapultsports/apis/openfield-connect-v6-api.md) - [All operations](https://skmtc.dev/catapultsports/apis/openfield-connect-v6-api/llms.txt) - [OpenAPI document](https://skmtc.dev/catapultsports/apis/openfield-connect-v6-api/revisions/4f0d7082f399?raw)