---
title: "Create a new variable set"
method: POST
path: "/runners/variables/variable-sets"
tags: ["Variable Sets"]
---

# Create a new variable set

`POST /runners/variables/variable-sets`

## Request body

- CreateVariableSetRequest
  - `name` string, required — Name of the variable set
  - `description` string — Description of the variable set
  - `labels` string[] — Labels to assign to the variable set
  - `parents` string[] — Parent variable set IDs
  - `variables` Variable[] — Initial variables to create in the variable set
    - `key` string
    - `value` string
    - `sensitivity` 'string' | 'secret'
    - `destination` 'env' | 'iac'

## Response `201`

Variable set created successfully

- CreateVariableSetResponse
  - `variableSetId` string — ID of the created variable set

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Insufficient permissions
- `500` — Internal Server Error

---

[API](https://skmtc.net/firefly/apis/api-gateway.md) · [All operations](https://skmtc.net/firefly/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/api-gateway/revisions/eea119b4113f/schema)