---
title: "Generate a Personal Access Token (PAT) in Web Client"
slug: "generateapersonalaccesstokenpatinwebclient"
updated: 2026-05-11T05:15:58Z
published: 2026-05-11T05:15:58Z
---

> ## 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 Web Client

> [!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 web client and generate PAT to use in the RESTful API.

### 1.1. How to Generate a PAT

> [!NOTE]
> To be able 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. Log in to the **12d Synergy Web** application and click the **Profile**![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/settings.doc-image-d2l4e1xy.jpg) icon and select the **Profile**option. ![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/webclientgenerateapersonalaccesstokenpatinwebclient.doc-image-i6g7odk3.png)
2. Click the **Personal Access Tokens**tab.
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)
7. 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.

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

> [!NOTE]
> ##### For v6 clients
> 
> You can create, delete, and view tokens in the 12d Synergy Client application also. Select the **Window menu option > My Profile** option > **Personal Access Tokens tab.**
> 
> ![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/pattab.png)

###