Create a system environment

POST

/api-catalog/system-environments

Creates a system environment for the authenticated team.

Authentication

x-api-keystring

API Key authentication via header

Authorizationstring

A valid SCIM API key for calls to SCIM endpoints.

A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Request

This endpoint expects an object.

namestringRequired1-255 characters

The system environment's name. This value must be unique within the team.

colorstringRequiredformat: "^#[0-9A-Fa-f]{6}$"

A six-digit hex color code.

labelstringOptionalformat: "^[a-z0-9_-]+$"<=50 characters

A lowercase, terminal-friendly identifier for the system environment. Accepts only alphanumeric characters, hyphens, and underscores.

descriptionstringOptional<=500 characters

A description of the system environment. To remove a description, pass this value as an empty string.

isProductionbooleanOptionalDefaults to false

If true, the system environment is a production environment.

Response

Successful Response

dataobject

Information about the system environment.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

$	curl -X POST https://api.getpostman.com/api-catalog/system-environments \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "ALPHA",
>	"color": "#00FF00",
>	"label": "alpha",
>	"description": "This is the ALPHA environment",
>	"isProduction": false
>	}'

1	{
2	"data": {
3	"id": "019d3dca-5e16-7bba-9f13-7abf00a6a443",
4	"name": "ALPHA",
5	"label": "alpha",
6	"color": "#00FF00",
7	"description": "This is the ALPHA environment",
8	"isProduction": false,
9	"createdAt": "2026-03-30T08:09:25.781Z",
10	"updatedAt": "2026-03-30T08:09:25.781Z"
11	}
12	}