Create a Personal Access Token (PAT) for an App

  • Updated on Aug 29, 2025
  • Published on Aug 25, 2025
  • 1 minute(s) read
Prev Next

  • We recommend using Personal Access Tokens (PATs) for authentication.

  • PATs provide stronger security, easier token management, and better compatibility with modern systems.

You can also generate the Personal Access Token (PAT) using the 12d Synergy/web client by following the steps here:

The steps include:

  • Inputting the necessary details for a PAT

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.

(Replace synergy.myserver.com with the external server address and update the port numbers if necessary.)

  1. Get a PAT in either the Web client or the 12d Synergy Client.

1.1. Getting the Personal Access Token to access API

The tutorial for getting the PAT is here: Generate PAT in Web client or Generate PAT in 12d Synergy Client

1.2. Create PAT

This request can be found in the API documentation under Authentication, marked 'Create a new Personal Access Token for an app'.

Then use the PAT retrieved above when creating a new PAT via REST.

Sample Request 

curl --location 'http://{your-server-here}/api/v1/auth/generate-pat' \

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

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

--data '{

  "ClientId": "Test 123",

  "Name": "asddadas",

  "ExpireInDays": 2

}'

Sample Response 

"AQAAANCMnd8BFdERjHoAwE_Cl-sBAAAAvKSFnblXOkGYZtcvtGQRWAAAAAACAAAAAAAQZgAAAAEAACAAAADyTaw1KclBYygguYZbKXZpl6-3dyF7pE3DsAoH7yXIHgAAAAAOgAAAAAIAACAAAABRiLEYTw7K8j82jYc_De02JQ1TX16KTUBFm_xQb5cUAdABAABZHycz_2Gn-VCokAYj8Qa6GWhjDxi1SkoFQfKHIRjLtnHLT5SRVLMJL7We4KBiOHVBlR3Qb-hWnvyp_E2Dbc6h71JCC_Uv0ENP7_L3BfzXVhlosxtD6JdW0efHDTJJ69SgoB5kT65N0avJNTL5ygk4hzTc2HN0qicKlnykmT4D0sCL9MfuQTCRcebCrExKGDWg6Xs5BwvAGcxtpXoAf5qe86czbIu6rwHOF9OdOjeDPe7mkwrV1hSswA0C75MzRySHUr9amsNcKSqcUpXNYqS9pmHMEgTe-hFaVeln5fUmWgy3GqxnQyWMIkNIcnTf2f1A9PyiCYqPdEN_DRFoMyPv4n72EXXSp00dk5PX8elAsiyR2M6eq17Cam1c-_gqPeeRK2uT7lGEaBLasKt37ZkUAUp9rxaMapRRA0epCuPlDDPF6NFNYnYOdQQBMUI0CE6Q-NRCXmnQfaNSo6Fz0bNzHnsKzMNEChLgfUsFirX0pjO6a0-xZG2y47YoxHWAlg93pqOGXi6zlVwg9JF_6lpJPSlIDGl2pUqdaTGB3u5830IhKCQenIUeJIR0QfGQrM5YzeotQstrTqUyBi3q_cYHIr2C9nwCpNkp3Rw1NHvUjUAAAAB8NmapideYtp7qDcFGTJy4IJcfkG2B0s8c8V8qvKk7SHCXsT0llynia-phkaTbPosAoUJvFy7ixdvQPY1fTzLA"