The CloudRadial AutomationAI Syncro extension lets a workflow or agent work with your SyncroMSP data: look up customers, contacts, technicians, and RMM assets, manage service tickets and their comments, and read invoices. This article covers what the extension can do, the API token and secrets it needs, which tools require approval, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Creating the API Token
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- Assigning and Commenting on Tickets
- Skills
- Tips for Working With Syncro Data
What the Extension Covers
The extension calls the SyncroMSP REST API and provides 16 tools across these areas:
| Area | What you can automate |
| Customers | List or search customers by name, email, or business, and read a customer's details, including contacts, address, and balance. Read-only. |
| Contacts | List a customer's contacts, read a contact, and create a contact under a customer |
| Tickets | List tickets by customer or status, read a ticket and its comments, create or update a ticket, assign it to a technician, and add a comment |
| Technicians | List Syncro users (technicians) and read one user's full record. Read-only. |
| Assets | List or search a customer's RMM assets (managed devices) and read one asset's properties and RMM details. Read-only. |
| Invoices | List invoices, optionally for one customer, and read an invoice's line items and totals. Read-only. |
Install it from Extensions like any other catalog extension. See Browsing and installing extensions for the general install flow.
Creating the API Token
In Syncro, go to Admin > API Tokens, create a token, and grant it the permissions for the areas you plan to automate. Copy the token value. The runner sends it as a Bearer token on every call.
Providing the Credentials to Your Runner
Store two secrets in your runner's Key Vault with these exact names:
| Secret | Value |
Syncro-ApiUrl |
Your account's API base URL, exactly https://{subdomain}.syncromsp.com/api/v1, with {subdomain} replaced by your Syncro subdomain |
Syncro-ApiKey |
The API token you created in Syncro |
For how to add these, see Accessing and updating your runner's Key Vault. The agent reads the credentials from the runner and never asks you for them. If you work in a separate Syncro account for a client, see Managing companies and per-company credentials.
Reads and Approval-Gated Changes
Of the 16 tools, 12 are read-only and run without interruption. The other 4 create or change something, and every one of them is approval-gated: the run pauses and the request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated | Create a ticket; update or assign a ticket; add a ticket comment; create a contact |
| Read-only | List and read customers, contacts, tickets, technicians, assets, and invoices |
The extension has no delete tools.
Assigning and Commenting on Tickets
To assign a ticket, the agent lists your Syncro technicians, finds the one you named, and updates the ticket with that technician's id. Name the technician and let the agent look up the id.
A ticket comment needs both a subject and a body. Two options control who sees it:
- hidden: set to true, it makes the comment an internal note
do_not_email: set to true, it stops Syncro from notifying the customer
Ask for an internal note when the customer should not see the comment.
Skills
The extension ships four skills that guide an agent through common Syncro tasks:
| Skill | Use it to |
| Manage Syncro Tickets | Find, read, open, update, assign, or comment on a service ticket. Creating, updating, and commenting are approval-gated. |
| Look up Syncro Customers and Contacts | Find a customer or contact, read their details, or create a new contact. Creating a contact is approval-gated. |
| Review Syncro Assets | Find or inspect a customer's RMM assets (managed devices). Read-only. |
| Look up Syncro Invoices | Find or read invoices, optionally for one customer. Read-only. |
Tips for Working With Syncro Data
- Refer to customers by name and let the agent look up the id. It resolves the customer before it filters tickets, contacts, assets, or invoices, or creates a record.
- List tools return the complete list in one call, following Syncro's 25-record pages for you up to a page limit. For large accounts, filter by customer or search text.
- Syncro allows 180 requests per minute from one IP address
- If every call fails, check that
Syncro-ApiUrlincludes your subdomain and ends in/api/v1, and that the token has the permissions the call needs
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.