> For the complete documentation index, see [llms.txt](https://docs.coherent.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coherent.global/spark-apis/folder-apis/create-folder.md).

# Create folder

Create a folder in your tenant. Folders contain Spark services.

Returns: `status` to indicate whether the request was completed.

{% code overflow="wrap" %}

```shellscript
POST /api/v1/product/create
```

{% endcode %}

### Authorization

* `Bearer {token}` accessible from [Authorization - Bearer token](/spark-apis/authorization-bearer-token.md) or systematically via [Client credentials](/identity-and-access-management/client-credentials.md).
  * The request headers should include a key for `Authorization` with the value `Bearer {token}`.

### Request body <a href="#request-body" id="request-body"></a>

The required request body needs to be in `form-data` format with the following values added.

| Key              | Value                                                                                                                                    |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `Name` \*        | Folder name.                                                                                                                             |
| `Category` \*    | Folder category. Must be a valid folder category. The category names are managed in [Options](/navigation/options.md#folder-categories). |
| `Description` \* | Folder description.                                                                                                                      |
| `Status` \*      | `Design` is the default value.                                                                                                           |
| `CoverImage`     | Image file for cover image.                                                                                                              |

### Sample response

`HTTP 200 OK` `Content-Type: application/json`

```json
{
    "message": null,
    "data": {
        "folderId": "66e9c8a9-335e-43b5-9353-39077d49d188",
        "get_product_url": "https://excel.myenvironment.coherent.global/api/v1/product/GetProduct/folderstatus"
    },
    "errorCode": null,
    "status": "Success"
}
```