---
title: "Generate a Personal Access Token (PAT) in 12d Synergy Client Application"
slug: "generateapersonalaccesstokenpatin12dsynergyclient"
updated: 2026-05-13T05:02:50Z
published: 2026-05-13T05:02:50Z
canonical: "help.12dsynergy.com/generateapersonalaccesstokenpatin12dsynergyclient"
---

> ## 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.

# Generate a Personal Access Token (PAT) in 12d Synergy Client Application

> [!TIP]
> We **recommend using Personal Access Tokens (PATs)** for authentication. PATs provide stronger security, easier token management, and better compatibility with modern systems.

This tutorial shows how to log in to the 12d Synergy Client application and generate a PAT to use in the RESTful API.

### **1.1. How to Create a Personal Access Token (PAT)**

> [!WARNING]
> You can create a PAT using the **12d Synergy Client** application only if you are working with **12d Synergy Version 6** by following this procedure. If you want to create a PAT using **12d Synergy Version 5**, please use the **12d Synergy Web** application.

> [!NOTE]
> To create a PAT, your 12d Synergy Administrator must have the following system setting set to **Yes**.
> 
> - **12d Synergy Administration** application > **System Settings** tab > **Web** section in the table (or **Search** for PAT) > **Creation and Authentication of Personal Access Tokens** setting.
> 
> If this setting is set to **No**, then the **Personal Access Tokens** tab is not displayed in the **Profile** window of the **12d Synergy Client and Web** applications.

1. In the **12d Synergy Client application > Window menu option > My Profile** option. The **My Profile** window is displayed.
2. Click the **Personal Access Tokens** tab. ![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/pattab.png)
3. Click the **Create New PAT** ![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/createbutton.jpg) button. The **Create new Personal Access Token** prompt is displayed.

![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/createdialog.jpg)
4. Enter a name for the token you are about to generate in the **Token Name** field.
5. Enter the number of days after which the token would expire in the **Expire in days** field.

The **Generate** button is now activated.
6. Click the **Generate** button. A token is generated and is displayed below the details you have entered.

![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/token(1).jpg)

Note that you can access this token only from this window. Hence, ensure to copy it using the Copy ![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/copy.jpg)button and save it to a safe place before you close this window.

The token is created, and you can view it in the **Personal Access Tokens** tab. However, you cannot view the token values in this tab.

### 1.2. How to use the PAT

The PAT should be added to the Authorization of each request sent as a Bearer token.

##### Sample Request (Finding jobs by name)

```SampleRequest
curl --location 'https://{your-server-here}/api/v1/jobs/?name=test&page=1&page_size=20' \

--header 'Authorization: Bearer {your-personal-access-token-here}' \

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

Click ![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/expand.png) in the line below to see the code.

##### Sample Response

```SampleResponse
{

  "PageNumber": 1,

  "PageSize": 20,

  "TotalRows": 1,

  "TotalPages": 1,

  "Result": [

    {

      "ID": {

        "_id": 1,

        "_server_id": 1,

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

        "IDString": "1_1"

      },

      "Name": "Test",

      "Description": "",

      "JobCreatorName": "",

      "CreatedDate": "2024-12-17T22:51:58.097",

      "NoOfChildren": 0,

      "NoOfFolders": 28,

      "NoOfTDJobs": 0,

      "InheritPermissions": true,

      "InheritFileNamingRules": false,

      "AlwaysDisplayParent": false,

      "DeleteLocked": false,

      "Type": "Normal",

      "CreatorID": {

        "_id": 1,

        "_server_id": 1,

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

        "IDString": "1_1"

      },

      "ParentJobID": null,

      "Attributes": [],

      "JobItems": null,

      "NoOfNotes": 0,

      "Path": "Test",

      "EntityObject": {

        "parent_project_id": null,

        "creator_name": "",

        "num_children": 0,

        "num_folders": 28,

        "num_td_projects": 0,

        "inherit_permissions": true,

        "always_display_parent": false,

        "rule_set": null,

        "inherits_file_naming_rules": false,

        "delete_locked": false,

        "cad_publish_output_path": null,

        "customisation_info": null,

        "id": {

          "_id": 1,

          "_server_id": 1,

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

          "IDString": "1_1"

        },

        "name": "Test",

        "create_date": "2024-12-17T22:51:58.097",

        "creator_id": {

          "_id": 1,

          "_server_id": 1,

          "_server_guid": "b993hm29-bf98-490c-949d-5621e3b48139",

          "IDString": "1_1"

        },

        "attributes": [],

        "description": "<HTML><HEAD>\r\n<META name=GENERATOR content=\"MSHTML 11.00.10570.1001\"></HEAD>\r\n<BODY></BODY></HTML>",

        "type": 0

      }

    }

  ]

}
```

Once the sample request above is sent with the proper token, it will receive a response similar to the one above.