The CloudRadial AutomationAI ConnectWise Manage extension lets a workflow or agent work with your ConnectWise Manage (PSA) data: service tickets and their notes, tasks, and time, companies and contacts, configurations, agreements, projects, sales opportunities, and schedules. This article covers what the extension can do, the API credentials it needs, which tools require approval, how it finds records, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Creating ConnectWise API Credentials
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- Resolving Names to Ids
- Querying and Result Limits
- Skills
- Tips for Working With ConnectWise Manage Data
What the Extension Covers
The extension calls the ConnectWise Manage REST API and provides 70 tools across these areas:
| Area | What you can automate |
| Service tickets | Search and read tickets, create, update, or delete a ticket, read and add notes and tasks, and list the configurations and time entries on a ticket |
| Service board lookups | Resolve boards and each board's statuses, types, subtypes, and teams, plus service priorities |
| Companies and contacts | Search and read companies, their sites and notes, and contacts, create or update a company or contact, and add a company note |
| Configurations | List a company's configurations (managed devices and configuration items), resolve configuration types and statuses, and create or update a configuration |
| Time | Query time entries, resolve work types and work roles, and log or correct a time entry against a ticket |
| Agreements and billing | Read agreements and their additions, search the product catalog, read invoices, and add a billable addition to an agreement |
| Projects | Read projects, phases, and project tickets, resolve project boards and statuses, and create a project or a project ticket |
| Sales | Read opportunities and activities, resolve opportunity types, statuses, and sales stages, create or update an opportunity, and log an activity |
| Scheduling | Read schedule entries and statuses, and assign a member to a ticket or activity for a time window |
| System | Look up members (technicians), list the documents attached to a record, and read system information |
Install it from Extensions like any other catalog extension. See Browsing and installing extensions for the general install flow.
Creating ConnectWise API Credentials
The extension signs in to ConnectWise Manage with an API member key pair and sends your integration client ID on every call. You need four values from ConnectWise:
- Your company ID: the short site or company code you sign in to ConnectWise with
- A public key and private key: an API member key pair, created in ConnectWise Manage under System > Members > API Members. ConnectWise shows the private key only once, at creation, so store it somewhere safe before you leave the page.
- A client ID: the integration client ID (a GUID) registered at
developer.connectwise.com
The runner signs in with HTTP Basic authentication, using your company ID and public key together as the username and the private key as the password. You do not combine them yourself; store each value as its own secret.
Providing the Credentials to Your Runner
Store five secrets in your runner's Key Vault with these exact names:
| Secret | Value |
CW-ApiUrl |
The full REST API base URL for your ConnectWise region, for example https://api-na.myconnectwise.net/v4_6_release/apis/3.0. Use your own region's host. |
CW-CompanyID |
Your ConnectWise company ID |
CW-PublicKey |
The public key of the API member key pair |
CW-PrivateKey |
The private key of the same key pair |
CW-ClientId |
Your ConnectWise integration client ID |
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 ConnectWise Manage instance for a client, see Managing companies and per-company credentials.
Reads and Approval-Gated Changes
Of the 70 tools, 49 are read-only and run without interruption. The other 21 create, change, or delete 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, update, or delete a service ticket; add a ticket note or task; create a company, update it, or add a company note; create or update a contact; create or update a configuration; log or update a time entry; add an agreement addition; create a project or project ticket; create or update an opportunity; log a sales activity; create a schedule entry |
| Read-only | Every search, get, and lookup tool, including invoices, documents, and system information |
Deleting a ticket removes it from ConnectWise permanently, and agents use it only when you explicitly ask. Review the ticket number carefully before you approve a delete. Updates change only the fields in the request; every other field on the record keeps its value.
Resolving Names to Ids
Every ConnectWise reference, such as a board, company, contact, status, priority, type, team, member, agreement, product, stage, project, or phase, is a numeric record id. Before any create or update, the agent looks up each name with the matching read-only lookup tool and passes the id it finds. It never guesses an id or falls back to a default, because a wrong id can file a record against the wrong board, company, or contact. If a lookup finds no match, or more than one, the agent stops and asks you which record you mean. If you already know a numeric id, give it, and the agent uses it directly.
When you build a workflow that creates ConnectWise records, put the matching lookup ahead of the create step so the id comes from your own ConnectWise instance rather than being hard-coded.
Querying and Result Limits
Search tools take a ConnectWise conditions filter and an optional sort order. String values use double quotes, for example status/name="Open" and company/identifier="ACME", and clauses combine with and and or. The runner pages through results for you.
- Record lists, such as tickets, notes, time entries, companies, configurations, projects, and invoices, return at most 300 records
- Lookup lists, such as statuses, boards, priorities, members, and types, return at most 2,000 records
A query that matches more than that fails with an "exceeded maxPages" error rather than returning a partial list. Narrow the conditions, for example by board, status, company, or a date range such as lastUpdated > [2026-10-01T00:00:00Z], and ask for only the fields you need, such as id,summary,status/name,company/name.
Skills
The extension ships ten skills that guide an agent through common ConnectWise Manage tasks:
| Skill | Use it to |
| Manage a ConnectWise Ticket | Search for, create, update, change the status of, or delete a service ticket. Creating, updating, and deleting are approval-gated. |
| Add Ticket Notes, Tasks and Activity | Read or add notes and tasks on an existing ticket, and review its configurations and logged time. Adding notes and tasks is approval-gated. |
| Log Time on a ConnectWise Ticket | Record time worked against a service ticket. Logging and correcting time is approval-gated. |
| Manage Companies and Contacts | Look up, create, or update a company or contact, or read company sites and notes. Creates and updates are approval-gated. |
| Manage Configurations (Managed Devices / CIs) | List, create, or update the configurations tied to a company. Creates and updates are approval-gated. |
| Manage Agreements and Billing | Review agreements, their additions, and invoices, or add a billable addition to an agreement. Adding an addition is approval-gated. |
| Manage Projects and Phases | Review or create projects, phases, and project tickets. Creates are approval-gated. |
| Manage Sales Opportunities and Activities | Review or manage opportunities, or log a sales activity. Creates and updates are approval-gated. |
| Schedule Work for a Member | View schedule entries, or assign a technician to a ticket or activity for a time window. Creating an entry is approval-gated. |
| System Lookups (Members, Documents, Info) | Look up members, find documents attached to a record, or check system information. Read-only. |
Tips for Working With ConnectWise Manage Data
- Refer to boards, companies, members, and statuses by name and let the agent look up the id
- A ticket note is a Discussion note, which the customer can see, unless it is marked Internal or Resolution. Ask for an internal note when the customer should not see it.
- Creating a contact does not set the contact's email address or phone number. ConnectWise stores those as communication items, which this extension does not set.
- A time entry is charged to a service ticket unless you say otherwise. The agent looks up the company, member, and work type ids before it logs the time.
- If a search fails with "exceeded maxPages," narrow it by board, status, company, or date rather than asking for everything at once
- If every call fails at sign-in, check that
CW-ApiUrlis the full base URL for your region and that all five secrets are set with the exact names above
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.