Skip to main content
Syncro authenticates with a single API token. Unlike ConnectWise or Autotask, Syncro has no API-only user type: every token belongs to a real Syncro user, and everything the token does is recorded as that user’s work.
Create a dedicated Syncro user for Neo first, and generate the token while signed in as that user. Without one, Neo’s comments, ticket edits and time entries appear as a named technician’s own work. The token also dies with the user: deactivate that person and the integration stops.

​
Before you start

Complete Creating a Security Group first. The Neo Agent SG group must exist and be assigned to your Neo user.
Syncro limits a token to the permissions of the user creating it: “The permissions available for selection are limited by the permissions of the current user.” The Neo user must already hold every permission you want on the token; anything it lacks is greyed out.
1

Open API Tokens

Signed in as the Neo user, go to Admin → API → API Tokens.
Admin → API → API Tokens in Syncro
2

Create a new token

Click New Token.
The New Token button on the API Tokens page
3

Choose Custom Permissions

Select the Custom Permissions tab, not App Integration. Name the token Neo Agent.
The New Token screen with the Custom Permissions tab selected
Expiration: leave it blank for a token that does not expire, or set a date and diarise the renewal. Syncro tokens are static, with no refresh. When a token expires, the integration stops working until you paste a new one into Neo.
4

Select the token permissions

Tick Select All Permissions. Syncro only offers permissions the Neo user holds, so “all” means all of the security group you scoped in the previous step; nothing beyond it can be granted.
Selecting all also means you never revisit the token as you enable more automations in Neo. To tighten or widen what Neo can reach, change the security group; that is the single place access is controlled.
Neo refuses to save a token without these seven:
  • Tickets - List/Search
  • Tickets - View Details
  • Tickets - Create
  • Tickets - Edit
  • Ticket Comments - New
  • Customers - List/Search
  • Customers - View Detail
The rest back capabilities you can enable later in the dashboard (time logging, scripts, RMM alerts, documentation, billing reads). Granting them now means you do not have to come back to the token.Tickets
  • Tickets - List/Search
  • Tickets - View Details
  • Tickets - View ‘Their Ticket’ Details (assigned to them)
  • Tickets - Create
  • Tickets - Edit
  • Tickets - Merge
  • Tickets - Use Ticket Charges
  • Ticket Comments - New
  • Ticket Custom Fields - Manage
  • Ticket Canned Responses - Manage
  • Ticket SLA - Edit
  • Ticket Blueprints - Manage
  • Ticket Blueprints - Create Ticket From Blueprint
  • Ticket Timers - Overview
  • Timelogs - Manage
Customers and contracts
  • Customers - List/Search
  • Customers - View Detail
  • Contracts - List/Search
  • Contracts - Edit
Assets, RMM and scripts
  • Assets - List/Search
  • Assets - View Details
  • RMM Alerts - List
  • RMM Alerts - Create
  • RMM Alerts - Clear/Manage
  • Scripts - Execute
  • Policies - List
Billing and inventory
  • Products - List/Search
  • Products - Create
  • Products - Edit
  • Products - Edit Quantities
  • Products - View Cost
  • Pending Orders - View All
  • Estimates - List/Search
  • Estimates - View Details
  • Estimates - Create
  • Estimates - Edit
  • Invoices - List/Search
  • Invoices - View Details
  • Line Item - View Cost
Other
  • Appointments - View All (see-own never restricted)
  • Documentation - Allow Usage
  • Documentation - Create
  • Documentation - Edit
  • Reports - View
5

Save and copy the token

Save the token, then copy its value from the tokens list. Paste it straight into Neo. Syncro will not show it again in full.
Neo validates the token when you connect and names anything missing. The troubleshooting table on the connect page lists the exact messages.

​
Next Steps

Connecting to Neo Agent

Enter your Syncro URL and this token in the Neo dashboard.