---
title: "Creating a folder"
slug: "creatingafolder"
updated: 2026-04-13T02:29:09Z
published: 2026-04-13T02:29:09Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.12dsynergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating a folder

This tutorial demonstrates how to create a folder via RESTful API.

> [!NOTE]
> Additional API documentation
> 
> To get a list of most of the API requests available, with the 12d Synergy server running, browse [http://synergy.myserver.com/api-docs/ui/index](http://localhost:8080/api-docs/ui/index).
> 
> (Replace [synergy.myserver.com](http://synergy.myserver.com/) with the external server address and update the port numbers if necessary.)

### 1.1. Getting the Personal Access Token to access API

The tutorial for getting the PAT is here: [Generate PAT in Web client](/v1/docs/webclientgenerateapersonalaccesstokenpatinwebclientdoc).

### 1.2. Retrieving Job ID

Refer to [Search Jobs](/v1/docs/searchjobsdoc) to get the required job ID.

### 1.3. Getting the Job Items

After selecting a job ID from the response above, the next step is to [get the job items using the job ID](/v1/docs/searchjobitemsdoc).

### 1.4. Creating a Folder using Job ID

Once you have selected a folder from the job items response, you can use that Job ID to create the folder.

**Sample Request**

```SampleRequest
curl --location 'http://synergy.myserver.com/api/v1/folders/create' \

--header 'Authorization: Bearer <your-token-here>' \

--header 'Content-Type: application/json' \

--data '{

    "job_id": {

        "_id": 1,

        "_server_id": 0,

        "_server_guid": "17200fcf-eb32-4771-84fd-9ab138528562",

        "IDString": "1_1"

    },

    "parent_folder_id": {

        "_id": 2,

        "_server_id": 0,

        "_server_guid": "17200fcf-eb32-4771-84fd-9ab138528562",

        "IDString": "2_1"

    },

    "folder_name": "<folder-name-here>"

}'
```

A successful response would look like this:

**Sample Response**

```SampleResponse
{

    "_id": 190164,

    "_server_id": 1,

    "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

    "IDString": "190164_1"

}
```