# Create environment variable


```
POST 
https://api.apify.com/v2/acts/:actorId/versions/:versionNumber/env-vars
```


Creates an environment variable of an Actor using values specified in a  passed as JSON in the POST payload.

The request must specify `name` and `value` parameters (as strings) in the JSON payload and a `Content-Type: application/json` HTTP header.


```
{
    "name": "ENV_VAR_NAME",
    "value": "my-env-var"
}
```


The response is the  as returned by the  endpoint.

## Request

### Path Parameters

* **actorId** string required

  Actor ID or a tilde-separated owner's username and Actor name.

  **Example:** `janedoe~my-actor`

  **versionNumber** string required

  Actor version

  **Example:** `0.1`

### Body**required**

* **name** string required\
  **Example:** `MY_ENV_VAR`
* **value** string required\
  **Example:** `my-value`
* **isSecret** boolean | null nullable\
  **Example:** `false`

### Status 201

**Response Headers**

* **Location**


```
{
  "data": {
    "name": "MY_ENV_VAR",
    "value": "my-value",
    "isSecret": false
  }
}
```


**Schema**

* **data** object required

  * **name** string required\
    **Example:** `MY_ENV_VAR`
  * **value** string required\
    **Example:** `my-value`
  * **isSecret** boolean | null nullable\
    **Example:** `false`

### Status 400

Bad request - invalid input parameters or request body.


```
{
  "error": {
    "type": "invalid-input",
    "message": "Invalid input: The request body contains invalid data."
  }
}
```


**Schema**

* **error** object required

  * **type** string required\
    **Example:** `run-failed`
  * **message** string required\
    **Example:** `Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)`