Personal Access Token
Found in: Account Management > Personal Access TokenPersonal Access Tokens (PATs) allow users to authenticate external systems, integrations, or scripts with SynControl without using their login password. These tokens are commonly used for API automation, third-party integrations, and secure programmatic access to resources such as bookings, clients, inspections, and reports.
Each generated token includes a set of scopes, which control what the token is allowed to access. This ensures secure and granular permission management.
Because Personal Access Tokens grant system access, they should only be created and managed by authorized users.
- Treat Personal Access Tokens like passwords. Never share them publicly.
- Once generated, the token is shown only once, store it securely.
- Assign only the required scopes needed for the integration.
- If a token is compromised, delete it immediately.
- Only users with sufficient permission rights can create tokens.
Navigation
Step 1: Click the user icon on the top-right corner of the SynControl dashboard.
Step 2: From the dropdown menu, select OAuth —> Personal Access Tokens.
This opens the token management page.
Personal Access Tokens Page
Here you can:
View all existing personal access tokens
Check token name, creation date, expiry date, and scopes
Create new tokens
Delete existing tokens
If no tokens exist, the list will be empty.
Create a New Personal Access Token
The token creation screen allows you to define the token’s name and specify the scopes (permissions) it will have.
Step 1: To create a new token, click: + Create New Token. This opens the token creation window.
The Name field is required. Choose a meaningful name such as:
“API Integration”
“Client Sync Automation”
“Testing”
A clear name helps identify the purpose of the token later.
Step 2: Select the permissions you want this token to have before creating it.
Step 3: After selecting the required scopes, click “Create”. The system will generate a secure token.
