Create a variable

Creates a new environment variable. Keys must be uppercase with underscores only (e.g. BASE_URL). Secret variables are encrypted at rest and masked in API responses.

Authorization

Authorization<token>

API key authentication. Allowed headers-- "Authorization: ApiKey <novu_secret_key>".

In: header

Request Body

application/jsonRequired

keyRequiredstring

Unique key for the variable. Must start with a letter and contain only letters, digits, and underscores.

Maximum length: 256Pattern: "/^[A-Za-z][A-Za-z0-9_]*$/"

typestring

The type of the variable

Value in: "string"

isSecretboolean

Whether this variable is a secret (encrypted at rest, masked in responses)

valuesarray<object>

Header Parameters

idempotency-keystring

A header for idempotency purposes

Response Body

_idRequiredstring

_organizationIdRequiredstring

keyRequiredstring

typeRequiredstring

Value in: "string"

isSecretRequiredboolean

valuesRequiredarray<object>

createdAtRequiredstring

updatedAtRequiredstring

export interface Response {
  _id: string;
  _organizationId: string;
  key: string;
  type: "string";
  isSecret: boolean;
  values: EnvironmentVariableValueResponseDto[];
  createdAt: string;
  updatedAt: string;
}
export interface EnvironmentVariableValueResponseDto {
  _environmentId: string;
  /**
   * Value is masked (••••••••) for secret variables
   */
  value: string;
}

curl -X POST "https://api.novu.co/v1/environment-variables" \
  -H "idempotency-key: string" \
  -H "Authorization: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "string",
    "type": "string",
    "isSecret": true,
    "values": [
      {
        "_environmentId": "string",
        "value": "string"
      }
    ]
  }'

{
  "_id": "string",
  "_organizationId": "string",
  "key": "string",
  "type": "string",
  "isSecret": true,
  "values": [
    {
      "_environmentId": "string",
      "value": "string"
    }
  ],
  "createdAt": "string",
  "updatedAt": "string"
}

Authorization

Request Body

Header Parameters

Response Body

On this page