--- title: "Creating a folder" slug: "creatingafolder" updated: 2026-04-13T02:29:09Z published: 2026-04-13T02:29:09Z canonical: "help.12dsynergy.com/creatingafolder" --- > ## 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 ' \ --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": "" }' ``` 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" } ```