Connect Autotask PSA, import native survey results for CSAT dashboards and reports, and choose data scope
This guide walks you through connecting your Autotask PSA instance to MSPortal.ai. MSP staff set up the connection; company users do not administer it. You connect, check permissions, choose data and match records on the Autotask connection page.MSPortal can also import Autotask native survey results into the CSAT Dashboard, custom dashboard widgets, report blocks and CSV exports. The import is off by default, and you can keep collecting feedback through Autotask’s own surveys. See Import Autotask native CSAT for dashboards and reports.
Prerequisites
Admin access to Autotask, or API credentials (username and secret)
Admin access to MSPortal.ai with integration management permissions
The Ticket Settings permission in MSPortal if you will edit ticket defaults
Part 1: Configure Autotask PSA
Before connecting to MSPortal.ai, you need to create an API user and security role in Autotask. See Autotask’s API user setup and REST authentication guides for background.
Create Security Role
MSPortal signs in to Autotask as one API user. That user can do exactly what its security level allows, so start from Autotask’s API level, remove what MSPortal never uses, and keep what it does.
See the MSPortal security level (PDF)
Every section of the security level, as exported from Autotask. It grants more than MSPortal needs in a few areas, such as Inventory. Where it differs from the tables below, follow the tables.
1
Open Security Levels
Sign in to Autotask as a user with HR admin rights
Go to Admin > Account Settings & Users
Expand Resources/Users (HR) and open Security Levels
2
Copy the API-only level
Open the menu beside API User (system) (API-only) and select Copy. Autotask does not let you edit the system level itself.
Rename the copy to MSPortal.
The copy starts with full access to everything, including deleting records. The next two steps trim it.
3
Remove what MSPortal never uses
MSPortal never deletes your Autotask records, so the biggest cut is Delete. Then switch off the areas it does not touch.
Where
Change
Every section
Set every Delete to None. The one exception is Service Desk > Service Calls, and only when you book work from Projects > Dispatch in MSPortal.
Documents & Knowledge Base
Select No Permission
Reports
Select No Permission
Projects and Service Desk
On the Expenses row, set View to None, Add to No and Edit to None
Inventory
Set every row except Products to None and No, and clear every box under Feature Access
Contracts
Set Can Approve & Post and Can Invoice to None
CRM
Clear every box under Feature Access and Opportunity Checklist Permissions
Admin
Clear every box except the ones listed under Admin in the next step. Make sure Application-Wide (Shared) Features (Full Access) is clear.
Other
Clear every box under Dashboard, Client Portal, Community Online and Miscellaneous
4
Keep what MSPortal uses
Check that the rows below are set as shown. A row marked Optional is needed only for the feature it names; the rest of the integration works without it. Where a row offers All or Mine, use All: Mine limits the API user to records assigned to it, so syncs miss records and updates to other people’s work fail.Autotask has renamed some labels between releases. Accounts may show as Organizations, and Configuration Items as Devices. Use whichever your screen shows.
Service Desk
Setting
Set to
Used for
Tickets: View
All
Sync tickets, their notes and attachments
Tickets: Add
Yes
Create the tickets people submit in MSPortal. With this set to No, every submission is emailed to your fallback inbox instead.
Tickets: Edit
Yes
Change status when a client replies, closes or reopens a ticket, and write mapped fields
Service Calls: View
All
Optional: Used to show service calls on the calendar
Service Calls: Add, Edit, Delete
Yes, Yes, All
Optional: Used to create, move and remove service calls when you book work from Projects > Dispatch
Can view non-billable time entries
On
Optional: Used to count non-billable time when time entries sync
Can modify Non-Billable setting on ticket time entries
On
Optional: Used when staff log ticket time from MSPortal and mark it billable or non-billable
CRM
Setting
Set to
Used for
Customer & Cancelation
All
Sync your client organizations, their locations and contacts
Vendor & Partners and Prospects, Leads, & Dead
All
Set to None if you do not want those organization types in MSPortal
Accounts: Edit
All
Optional: Used by Traffic Light Review, a pilot feature, to write a customer’s status to organization fields and a company alert. Otherwise set it to None.
Notes: Add, Edit
Yes, All
Optional: Used to save account notes written in MSPortal to Autotask
Opportunities & Quotes: View
All
Optional: Used to sync opportunities
Opportunities & Quotes: Add
Yes
Optional: Used to create an Autotask opportunity from an MSPortal quote. Also tick Can modify Opportunity Owner (reassign Opportunities).
Configuration Items & Subscriptions: View
All
Optional: Used to import devices from Autotask
Configuration Items & Subscriptions: Edit
All
Optional: Used to write warranty dates to devices with warranty writeback
Attachments: View, Add
All, Yes
Read and upload attachments
Contracts
Skip this section unless you sync contracts or invoices.
Setting
Set to
Used for
Contracts: View
All
Sync contracts, their services and charges
Contract Visibility
Full
Read the services, bundles and charges on each contract
Can access Invoice History, (Invoice) Export Wizard and Payments
On
Optional: Used to sync invoices. With this clear, Autotask refuses to list invoices.
Inventory
Setting
Set to
Used for
Products: View
All
Optional: Used to sync the product catalog
Projects
Skip this section unless you use Autotask projects in MSPortal. See Project management permissions for the project-specific checks.
Setting
Set to
Used for
Client & Internal: View
All
Sync projects, phases, tasks and time entry notes. Autotask lets anyone who can view a project also edit it, so this row also covers changing status, owner, dates and mapped fields from MSPortal.
Client & Internal: Add
Yes
Optional: Used to create Autotask projects from MSPortal, including from templates
Project Templates: View
All
Optional: Used to import Autotask project templates
Can enter time on
All Tasks
Optional: Used to log time against project tasks
Can modify Non-Billable setting on task and issue time entries
On
Optional: Used when staff mark project time billable or non-billable
Admin
Autotask keeps its setup lists behind these Admin areas. MSPortal reads them and changes nothing. Keep these ten and clear every other box in the section.
Setting
Set to
Used for
Your Organization
On
Your company’s locations and settings
Resources/Users (HR)
On
Staff, roles and departments, to match staff and fill assignment lists
Accounts & Contacts
On
Organization types and classifications
Service Desk (Tickets)
On
Queues, statuses, priorities, issue types and ticket categories
Projects & Tasks
On
Project and task setup lists
Sales & Opportunities
On
Opportunity stages and categories
Products, Services, & Inventory
On
Products, services and work types
Configuration Items
On
Device types and categories. With this clear, device import cannot read them.
Finance, Accounting, & Invoicing
On
Payment terms and invoice setup
Contracts & Un-Posting
On
Contract setup lists
Other
Setting
Set to
Used for
Can create Webhooks
On
Ticket and note changes reach MSPortal within seconds
Maximum number of Webhooks
25
Room for the ticket and ticket note webhooks
Can view Account Survey Ratings and Contact Survey Ratings
Resource Impersonation lets MSPortal add tickets, notes and time on behalf of a staff member, so Autotask shows that person as the author instead of the API user. Tick these boxes and leave every Delete box clear:
Leave Accounts, Contact, Sales Orders, To-Dos, every Inventory row and the two time off boxes clear. Autotask also requires the security level of each staff member MSPortal acts for to allow impersonation.Contact Impersonation lets the API user add items on behalf of a client contact. Tick Add on Project Notes, Task Notes, Tickets, Ticket Notes and Attachments.When a staff member has no linked Autotask resource, MSPortal adds the note as the API user and puts their name in the note title.
Turning a feature on later? Set its rows here first, then select Re-check on the connection’s Permissions task in MSPortal.
5
Save the Role
Click Save & Close.
After you connect, the Permissions task in MSPortal checks this level from Autotask’s side: each area MSPortal reads, and whether the API user may create and update tickets. It names the setting to change for anything missing. See Permissions.
Create API User
1
Navigate to Users
Go back to Account Settings & Users
Select Resources/Users
Click to add a new API user
2
Configure API User
Fill in the following details:
Field
Value
First Name
MSPortal
Last Name
Integration
Security Level
MSPortal (the role you created)
Email Address
Use an internal alias for receiving integration logs
Primary Internal Location
Select your headquarters
Integration Vendor
MSPortal.ai
The MSPortal connection form asks only for the API username and secret. It has no field for a custom tracking identifier, so set the integration vendor here. If Autotask rejects the tracking identifier, confirm the vendor association with your Autotask administrator.
3
Generate API Credentials
Under Credentials, click Generate Key
Click Generate Secret
Important: Save the API username and secret immediately. The secret cannot be retrieved later.
Make sure to copy and save your API credentials before closing this dialog. The secret cannot be viewed again after creation.
4
Associate Lines of Business
Associate the appropriate lines of business with the API user, then click Save & Close.
Project management permissions
Skip this section unless you create or update Autotask projects from MSPortal. Syncing projects needs only the View row under Projects in Create Security Role.These settings go on the security level of the API user whose credentials are saved in MSPortal. A technician’s own security level does not give the integration any access.
1
Grant project access
In Autotask, go to Admin > Account Settings & Users > Resources/Users (HR) > Security Levels, edit the MSPortal level and open Projects. Autotask treats project tasks separately from service tickets, so Service Desk ticket access alone is not enough.
What you do in MSPortal
Rows it needs under Projects
See projects, phases, tasks and time entry notes
Client & Internal: View set to All
Change status, owner, priority, dates, estimated hours or mapped fields
The same View row. Autotask lets anyone who can view a project also edit it, so there is no separate Edit setting.
Create projects, phases and tasks, including from templates
View, and Client & Internal: Add set to Yes
Log time against project tasks
View, and Can enter time on set to All Tasks
Three things to check while you are there:
Line of Business. Autotask can hide projects and tasks by Line of Business even with View set to All, so include every Line of Business the integration should see.
Time entries. The API user must be allowed to enter time for the resource the time belongs to. Enable the billing field permissions if staff set billable or non-billable time.
No deletes. MSPortal never deletes a project, phase or task. Keep Delete at None on the Task Notes and Charges rows.
Baseline project tasks stay read-only, and Autotask’s rules for completed tasks and submitted or posted time still apply. See Autotask’s task access rules and time entry requirements.
2
Save and re-check
Save the security level. In MSPortal, go to Settings > Integrations, open the Autotask PSA connection, select Permissions and click Re-check.
3
Test on a project
A green Projects result only confirms MSPortal can read projects. Create a test project, edit a task and log time on it to confirm write access. If applying a template partly succeeds, check the records it created before you retry. An Autotask administrator can also inspect the API user’s effective access with Autotask’s entityInformation permissions.
In MSPortal, Autotask project task notes are time entry notes. Standalone project task notes and editable checklist items are not available for Autotask, and extra Autotask permissions will not turn them on. MSPortal-only projects and templates use MSPortal permissions only.
What MSPortal writes back to Autotask projects
Autotask projects are two-way for status and dates. You do not need to repeat these changes in Autotask:
Project status, from the portfolio Kanban or the project’s status.
Task status, from the project Board or ticket details.
Task owner, from the Resources board or the project Board.
Project, phase and task dates, from Reschedule, Edit dates, Projects > Dispatch, or ticket and phase details. An Autotask phase date change needs both a start date and an end date.
MSPortal writes to Autotask first and updates its own copy only after Autotask accepts the change. If Autotask rejects it, MSPortal shows an error and keeps the old value.Some changes stay in MSPortal. Rename phases in Autotask, because MSPortal does not send phase renames. Phase descriptions and notes, milestones, and project and onboarding templates stay in MSPortal. Onboarding task status syncs with Autotask, and an onboarding task due date changed in the portal is written to the linked Autotask task. Onboarding phase dates stay in MSPortal. See What writes back to your PSA.
Part 2: Connect Autotask in MSPortal
The Autotask connection page lists its setup tasks in the Setup guide: Connect, Permissions, Choose data, Import or match companies, Import or match users, Import devices, Configure tickets, Configure opportunities and Review. Import or match users, Import devices and Configure opportunities are optional. Select a task to return to it at any time.
Open the connection
1
Navigate to Integrations
In MSPortal.ai, go to Settings > Integrations.
2
Start Setup
Find Autotask PSA and select Connect. To continue an existing setup, open the existing Autotask PSA connection instead.
Connect
1
Enter API Credentials
Fill in the following fields:
Field
Description
API username
Your Autotask API user email (e.g., api.user@yourdomain.com)
API secret
The API secret generated for your API user
2
Test the connection
Select Test connection and resolve any reported error. A successful test does not save the connection.
If the connection fails, verify your API username and secret are correct and that the API user has the MSPortal security role assigned.
3
Save and continue
Select Save and continue to create the connection, then continue to Permissions.
Permissions
MSPortal checks what your Autotask API user is allowed to read, and whether it may create and update tickets, and shows the result for each area. The check only reads your security level; it never creates or changes anything. If the check has not run yet, select Run check.
1
Review the results
Each area of data is listed as Granted, Not permitted or Could not verify.Areas marked Required must be granted before you can continue: Companies, Contacts and staff, Tickets, and Queues and statuses. Without these the integration cannot function.Other areas cover Ticket creation and updates, Configurations, Opportunities, Product catalog, Invoices, Contracts, Projects, Time entries, Service calls, Company notes, and Satisfaction feedback. You can continue and fix them later.If Ticket creation and updates is Not permitted, the API user can read tickets but its security level has Tickets Add or Edit set to No under Service Desk. Until you change it, tickets submitted in MSPortal are emailed to your fallback inbox, and the message says the PSA was unavailable.
2
Grant anything missing
Any area that is not permitted names the security level setting to change.Update the security level assigned to your API user, then come back and click Re-check. Every setting MSPortal uses is listed under Create Security Role.
Could not verify usually means Autotask was slow or unavailable, not that a permission is missing. Click Re-check before you change the security level.
3
Continue
Optional areas that are not granted keep their syncs switched off, and their switches in Choose data stay locked until you grant the permission and re-check.
These checks test read access only. A green result does not prove that ticket creation, comments, warranty updates or other writes will succeed.
If a permission is removed later, MSPortal switches off the affected sync and notifies your integration admins rather than retrying against an entity it can no longer read.
Choose data
Choose what data to sync from Autotask and set up automatic imports. Each switch and filter saves as you change it, so wait for the saved state before you leave. Switches sit side by side in two groups, Core data (companies, users and tickets) and Extended data. Turning on a dataset reveals its settings below that group; turning it off hides them without clearing saved choices. Each switch and selector has an (i) beside its name: hover over, tap or focus it to read what the setting does. Start the initial sync when it is offered. Options in later tasks can stay incomplete while it runs.
1
Choose datasets
Option
Description
Sync Users
Sync user/contact data from Autotask
Sync Companies
Sync company/account data from Autotask
Enable Ticket Sync
Sync tickets from Autotask
Enable Opportunity Sync
Sync opportunities from Autotask
Enable Project Sync
Sync projects from Autotask. Project templates and baselines stay out of the project list and its totals. To reuse a template, import it as an MSPortal template.
Enable Invoice Sync
Sync invoices from Autotask
Sync product catalog
Import the product and service catalog for quoting and budgets
Enable configuration item sync
Sync configuration items into device staging for reporting and import
A switch appears locked when the permission check found that your API user cannot read that data. Grant the permission named beside it in Autotask, then select Re-check in Permissions to unlock it.
2
Configure Contact Auto-Import
If you want contacts to be automatically imported when companies are added:
Turn on Contact Auto-Import to automatically create user accounts for active contacts
Select a Default Role for Imported Contacts (e.g., Viewer)
Optionally, under Portal roles by contact type, select Add rule to give specific Autotask contact types other portal roles. Unmapped types use the default role.
We recommend choosing a role with minimal permissions (basic ticket creation only) if you plan to import all contacts.
To create portal users from your clients’ Microsoft 365 tenants instead, use an access rule with the action Import Microsoft 365 users (branch preview). See Set access rules.
3
Deactivate contacts with Microsoft 365 (optional)
Deactivate the contact when Microsoft 365 disables the person (preview; appears once MSPortal turns it on for your MSP): with Sync Users on, this switch sits below Contact Auto-Import. When Microsoft 365 blocks a client user’s sign-in and MSPortal disables that user, MSPortal marks each of their linked, active Autotask contacts inactive, so the person can no longer open or reply to tickets by email. When Microsoft 365 enables the person again, MSPortal reactivates exactly the contacts it deactivated.
It applies to people Microsoft 365 disables after you turn it on. People who are already disabled are left alone.
A contact that was already inactive is never recorded, so MSPortal never reactivates a contact you deactivated yourself.
Disabling someone yourself in MSPortal, or for any reason other than Microsoft 365, never changes their Autotask contact.
It needs a Microsoft 365 connection. Changes are sent after each Microsoft 365 users sync, and a failed change is retried up to five times.
Turning it off stops new deactivations. Contacts MSPortal already deactivated are still reactivated when Microsoft 365 enables the person.
The Recent contact changes button below the switch opens a dialog listing each contact MSPortal changed, and why one was left alone or failed. It refreshes while open. The button needs read access to company users. The API user must be allowed to edit Autotask contacts; a refusal shows there.
4
Configure Company Auto-Import and Filters
Setting
Description
Auto-Import Company Types
Companies of the selected types are created in the portal automatically during sync. MSPortal asks you to confirm before it imports a new batch, because companies are a billed item.
Exclude Company Types
Select company types to exclude from sync
5
Configure Ticket Sync Scope
With Enable Ticket Sync on, define which tickets to sync:
Setting
Description
Sync recurring tickets
Include tickets generated from Autotask recurring ticket templates
Queues to Sync
Select which Autotask queues’ tickets to sync
Exclude Statuses
Select ticket statuses to exclude from sync
Categories
Select the ticket categories to sync, or leave it empty to sync every category. Categories added in Autotask later stay unselected until you add them; the note under the field lists the categories whose tickets don’t sync.
6
Choose invoice visibility
With Enable Invoice Sync on, use Hide invoice statuses to hide closed, voided or other statuses from the Invoices page. Every invoice still syncs.
7
Configure Planner Auto-Import (Optional)
With Enable Opportunity Sync on, turn on Auto-import to Planner, below the Extended data switches, to create a planner item for each new Autotask opportunity. Use Minimum opportunity value and Opportunity types to auto-import to limit which ones come through. See Importing PSA Opportunities.
Synchronizing source records, linking them to companies and importing portal records are separate steps. Automatic company and contact imports can create portal records when matching source records arrive, so review filters and auto-import settings before you turn them on. Check errors and the actual sync result before you treat an empty list as the final dataset.
Branch preview: MSP staff in the Demo tenant.
Phone layout
Branch preview: MSP staff in the Demo tenant.
Import or match companies
Open Import or match companies. Its first view, Import, includes unlinked records with or without suggestions; use Suggested to review proposed matches.
Select Import beside a source company to import it on its own.
Select Import companies to open the selection dialog. It loads unmatched records across pages for the current search. Use Select current page or Select all pages, review the names and selected count, then confirm. Existing portal companies with the same name are matched instead of duplicated.
To link a company that already exists under a different name, choose it in the row, or review and accept the suggested match. Review N suggested matches opens Accept suggested matches, which lists every suggestion at 70% confidence or more with those at 90% or more already selected. Lower the Auto-select by confidence slider, as far as 70%, to select weaker suggestions too, untick any pair you want to check yourself, then select Apply N Matches.
Accepted matches, removed matches and ignores save when applied. Opening the import dialog alone saves nothing. See Import companies for selection scope and retry guidance.
Branch preview: MSP staff in the Demo tenant. Suggestions at 90% or more start selected.
Import or match users (Optional)
Import or match at least one company first. You can leave other companies for later and return to import more users.
1
Select contacts
The workspace opens on Import, which includes suggested contacts too. Use Import beside a contact, or select contacts and choose Import selected. Use the header checkbox to select the current page, click it again to select all pages matching the current filters, and click again to clear the selection. Select all with email replaces the selection with contacts that have an email address across all pages matching the current filters. Large selections run in batches.
2
Review and confirm
In the review panel, choose the intended Company role and review the ready-to-import and skipped counts. Contacts without an email address are skipped; you can add an address before confirming. Correct invalid addresses or clear them to skip those contacts, and resolve duplicate addresses.
3
Check the result
Read the result and verify the saved users. To link an existing account instead, choose that user or accept a reviewed suggestion. Importing contacts does not invite them to the portal.
Client contacts are imported here. See Import users for selection scope and retry guidance.
Import devices (Optional)
Import Autotask configuration items as devices in MSPortal. Make sure Enable configuration item sync is on in Choose data, then open Import devices to map configuration item types to MSPortal device types and select the items to import. Confirm the intended company and device type before importing, then check the result in Devices.
Configure tickets
Set up how Autotask tickets behave in MSPortal. Each change saves straight away. Wait for the saved state and resolve any reported save failure before you leave.
1
Review new ticket defaults
New ticket defaults sets the PSA values used for new tickets created in the portal. These are the same defaults as Settings > Tickets, and editing them requires the Ticket Settings permission. It includes the Requester field, which records each submitter’s name in a ticket UDF. See Requester field.
2
Choose ticket statuses
Under Ticket statuses, select the Closed statuses that mean a ticket is closed. Status choices appear once queues are chosen in Choose data; missing choices can mean the first metadata sync has not finished. To set a status after a company user replies, see Set the status after a client comment.
3
Place statuses in resolution stages
Resolution stages drive the visual indicator of ticket progress. Place each Autotask status in the stage it belongs to. A status can sit in one stage only.
Stage
Description
New
Tickets that are newly created or not yet triaged
Triaged
Tickets that have been reviewed and prioritized
Working
Tickets actively being worked on
Waiting
Tickets waiting for customer response or approval
Resolved
Tickets that are completed or closed
4
Set Autotask ticket defaults
Setting
Description
Fallback Resource
Assigned when creating tickets without a specific resource. Cannot be an API-only user.
Default Note Type
Default note type for ticket comments
Account Note Action Types to Sync
Only company notes with these Autotask action types are imported and shown on the company Notes tab. Leave empty to sync none.
5
Set a reply mailbox for emailed notes (Optional)
Emailing ticket notes is off until you turn it on in Settings > Tickets > General > Email ticket notes. To let staff and company users email a ticket note on this connection, also set Reply mailbox under Emailing contacts from notes. Enter the mailbox Autotask reads incoming email from. MSPortal sends the note from your sending domain with this mailbox as the reply address and the ticket number in the subject, so a reply is added to the ticket. Without it, the Email to field is not offered on this connection’s tickets.
6
Sync actions
Action
Description
Sync tickets now
Trigger an immediate sync of ticket data
Clear & Resync
Delete this integration’s synced tickets in MSPortal and perform a fresh sync (useful after major configuration changes). Tickets in Autotask are not affected.
Branch preview: These Autotask reply settings and screenshots describe an
unreleased update. They are not yet verified in production.
Use this setting to move an Autotask ticket to a chosen status after a company user successfully saves a public note through MSPortal. MSP staff notes, internal notes and private notes do not trigger it.You need permission to manage integrations. The Autotask API user also needs TicketsEdit on its security level. Ticket creation and updates under Permissions shows whether it has that.
1
Open Configure tickets
Go to Settings > Integrations > Autotask PSA, open the connection you want to change, and select Configure tickets in its setup guide.
2
Choose a reply status
Under Ticket statuses > Status after a client comment, select an active status from this Autotask connection. Choose None to turn the automatic status update off.
3
Choose what happens on closed tickets
Replies on closed tickets becomes available after you select a reply status.
Choice
Result after a company user’s public note
Keep closed or resolved (default)
Save the note and leave a closed or resolved ticket’s status unchanged.
Change to reply status
Apply the selected reply status even when the ticket is closed or resolved. Choose an open reply status if you want replies to reopen tickets.
Closed-ticket handling includes statuses marked closed in Autotask, your Closed statuses, and statuses placed in the Resolved resolution stage.
4
Wait for each change to save
Each selection saves immediately. Resolve any save error before leaving, then reload to confirm the saved choices. To stop automatic status changes later, select None.
The setting applies to this integration’s tickets. Company overrides are not supported in this release. MSPortal writes only the reply status for this step; it does not write the assigned technician, queue or priority. Autotask workflows may react separately to the status change.
Desktop
Phone
Branch preview in MSPortal Demo: In Progress is an example reply status; closed or resolved tickets stay closed by default.
Branch preview in MSPortal Demo: the same reply settings on a phone.
If the note saves but the status update fails, the portal and browser extension tell the company user that the note was saved and offer Retry status update when a retry is available. Retrying changes only the status and never posts another note. See When a reply changes the ticket status.
Problem
What to check
No reply statuses are available
Check this connection’s selected queues and metadata sync, then reload. The target must be an active status from this integration.
A staff note did not change the status
Only company users’ public notes trigger this setting.
A closed ticket stayed closed
Keep closed or resolved is the default. Select Change to reply status only if replies should apply the chosen status to closed tickets too.
A note saved but its status did not update
Check the Autotask connection, API user’s write access and whether the selected reply status is still active. Retry the status when offered; do not post the note again.
Configure opportunities (Optional)
Set default values for opportunities created from MSPortal. These settings only apply when Enable Opportunity Sync is on in Choose data.
Setting
Description
Fallback Owner
The owner assigned to opportunities when the user doesn’t have an Autotask account. Cannot be an API-only user.
Default Category
Default category for new opportunities (optional)
Default Stage
The starting stage for new opportunities (required by Autotask)
Default Status
The starting status for new opportunities (required by Autotask)
Projected Close Date (Days from Start)
Number of days from start date for projected close
This task also controls how synced opportunities reach the Planner. Automatic Planner imports and their filters stay in Choose data.
Review
Open Review, resolve any required incomplete tasks, then select Finish setup. Each task saves its own changes, so finishing setup does not apply a separate batch of pending company or user imports. Syncs and imports keep running in the background; check their results separately.
Managing Your Integration
After setup, open the Autotask PSA connection from Settings > Integrations:
Overview and Sync activity: Check connection status, sync results and errors
Setup guide tasks: Change saved scope, matches and settings
Run sync: Request a manual sync of all data, or one data type
More actions > Rename: Label the connection
More actions > Disconnect…: Remove the stored credentials, company matches and synced data after confirmation. This cannot be undone. Revoke the API user’s credentials in Autotask separately.
To replace the API credentials, open Connect, enter the new username or secret, select Test connection, then select Save changes. Leave masked values unchanged to keep them. A test alone does not save replacement credentials, so confirm the saved connection before you revoke the old credential in Autotask.
Webhook Management
MSPortal provisions the Autotask webhooks for ticket changes, so no manual webhook setup is required in Autotask. A weekly check re-creates any webhook that has gone missing. If webhooks stop working, verify that your API user’s security role still allows creating webhooks, then contact MSPortal support.
Write warranty dates back to Autotask
Warranty writeback is an optional write to Autotask. Turn it on only when you want MSPortal’s warranty dates to update Autotask configuration items.
1
Turn on Warranty writeback
Open the Autotask PSA connection, select Choose data and turn on Warranty writeback. It does not need Enable configuration item sync. Devices are matched by RMM device UID, then by serial number in the mapped company.
2
Wait for the save
The switch saves as soon as you change it. Wait for the saved state before you leave.
Import Autotask native CSAT for dashboards and reports
This imports survey results already collected by Autotask’s built-in surveys. You do not need Simplesat or a new MSPortal survey. The import is off by default.
1
Grant survey rating rights
In Autotask, open Admin > Resources/Users > Security Levels and edit the level assigned to the API user. Under Other > Surveys, enable Can view Account Survey Ratings and Contact Survey Ratings and Can view Resource Survey Ratings.
2
Re-check permissions
In MSPortal, open the Autotask PSA connection, select Permissions, click Re-check and confirm Satisfaction feedback is granted.
3
Turn on the import
Open Choose data and turn on Import satisfaction ratings. There is no rating scale to choose, because Autotask survey questions rate 1 to 5. Each completed survey’s overall rating is rounded to a whole number on that scale.
4
Start the first import
Wait for the switch to save, then start the sync when it is offered. Later imports run hourly. A saved setting does not mean every response has arrived.
5
Check company links
Make sure the surveyed companies are linked to portal companies and their tickets have synced. A result whose company is not linked will not appear in company-scoped CSAT results until a later sync can resolve it. Technician attribution uses the assigned resource on the synced ticket.
6
Grant read access
Give intended readers Surveys > Read > CSAT in their role. Building dashboards and reports also needs the matching permissions.
Only completed surveys are imported. Surveys that were sent but not answered, and surveys completed without answering any rated question, are not counted. Autotask does not provide free-text survey answers to integrations, so imported responses carry ratings only.
Present the imported results
Where
How
CSAT Dashboard
Open Surveys > CSAT Dashboard to read scores and trends, or export responses. Autotask results are grouped under Autotask PSA satisfaction. See Read and export support satisfaction feedback.
Custom dashboards
Add CSAT Overview, CSAT Trend, CSAT by Company or Recent CSAT Feedback from the widget library, then save the dashboard. See Create and edit a dashboard.
Reports
Use the same CSAT blocks in the report builder, select the company and reporting period, and save. See Reporting.
These CSAT views can include other connected feedback sources alongside Autotask. Check the company selection, dates and survey filter before you read a total as Autotask-only.
If Autotask CSAT is missing
Connecting Autotask does not turn on the import by itself. Check that Import satisfaction ratings is saved, Satisfaction feedback is granted, the companies are linked, the tickets have synced and the reader has the CSAT permission. If the Import satisfaction ratings switch does not appear at all, contact MSPortal support.
Additional Configuration
After completing setup, you may want to configure additional settings:
Configure Ticket Settings
Navigate to Settings > Tickets to:
Set the Delivery Method to PSA
Ensure Autotask is selected as your PSA provider
Configure ticket categories and map them to Autotask ticket types
Set Ticket Defaults for tickets created from compliance tasks or automation
Ticket defaults are also used as the starting point for new ticket templates, making template creation faster.
Configure Display Groups
Display groups control which ticket fields users can see based on their role.
Navigate to Settings > Tickets
Scroll to Display Groups and click Create Group
Configure:
Name for the display group
Select Autotask as the PSA provider
Assign roles that should use this display group
Select which fields are visible
Only grant access to information users need for their role. Follow the principle of least privilege.
Configure Allowed Statuses
Set which ticket statuses users can select when updating tickets:
Navigate to Settings > Tickets
Configure status permissions for each display group
We recommend preventing users from closing tickets directly. Instead, use a “Ready for Review” status to ensure tickets are reviewed before closure.
Devices from Autotask configuration items
MSPortal treats an RMM, MDM or network tool as the source of truth for a device. When an RMM is connected, a Autotask configuration item keeps or creates a device only when its type has Auto-import on and is not ignored in Import Devices. Configuration items of other types add their details to devices your RMM reports.
Configuration items removed in Autotask. Once a day MSPortal checks the full list of active configuration items in Autotask. A configuration item that is deleted or made inactive is removed from staging three days after Autotask stops listing it, and stays if it comes back in the meantime.
What happens to the device. When the configuration item leaves staging, its device moves to another integration that still reports it, such as your RMM. A device nothing else reports is removed. In a tenant with an RMM, an IT Glue or other PSA record keeps the device only when its type has Auto-import on.
Only companies still mapped to this connection are affected. Unmapping a company or excluding a type stops syncing those records and keeps their devices. Archived devices are never removed.
Troubleshooting
Issue
Solution
Connection test fails
Verify your API username and secret are correct. Ensure the API user has the MSPortal security role. Read the reported error text.
A data option is unavailable
Check its result in Permissions, grant the named permission and select Re-check.
Tickets not syncing
Check that the correct queues and categories are selected in Choose data and that ticket statuses aren’t excluded. The note under Categories lists categories that don’t sync, including ones added in Autotask after setup. See Fix missing tickets.
Companies or tickets are missing
Check saved filters in Choose data, the result in Sync activity and company links.
New statuses are absent
Wait for metadata to sync, check the selected queues and reload the task.
Webhooks not working
Ensure your API user’s security role can create webhooks, then contact MSPortal support.
Missing data
Open Permissions, select Re-check and grant the setting named beside anything not permitted. The rows are listed under Create Security Role.
New tickets arrive by email saying the PSA was unavailable
Ticket creation and updates is not permitted. Under Service Desk, set Tickets Add and Edit to Yes on the API user’s security level.
Contacts not importing
Verify Contact Auto-Import is on and a default role is selected in Choose data.
Setup finished but records are absent
Check background errors in Sync activity, imports you have not run yet and the selected company.
Projects load, but a status or task edit fails
Check Client & Internal View is set to All, then task restrictions and Line of Business scope.
Creating a project or applying a template fails
Check Client & Internal Add is set to Yes, and the resource and work type choices. Check partial results before retrying.
Logging project time fails
Check TimeEntries create access, Can enter time on, the resource mapping, billing field permissions and Autotask’s completed task and timesheet rules.
Survey results are missing from CSAT views
Check the saved Import satisfaction ratings switch, the security level’s survey rating rights, company links, synced tickets and the reader’s CSAT permission.
Frequently asked questions
Does Test connection only test credentials?
Yes. Select Save and continue after a successful test to create a connection, or Save changes to save replacement credentials on an existing connection.
Does a green permissions result verify ticket writes?
Yes, for tickets. Ticket creation and updates reads whether the API user may add and edit tickets, without creating one. Other writes, such as projects, time entries and warranty dates, are not checked: confirm those with a real action.
Does MSPortal write back to Autotask, or is it one way?
It writes back. Project status, task status, task owners, and project, phase and task dates you change in MSPortal are written to Autotask, so you do not update them again there. Phase renames, milestones and onboarding portal dates stay in MSPortal. See What MSPortal writes back to Autotask projects.
Does Finish setup mean all data is ready?
No. Check the background sync result and verify company, user and device imports separately.
Will every discovered contact receive portal access?
Discovery and import are separate. Review user matches, company links and the permissions assigned to portal users; invitation is a separate workflow.
Can I dashboard or report on Autotask native survey results?
Yes. Turn on Import satisfaction ratings in the Autotask connection’s Choose data task and grant the API user’s security level the survey rating rights. Completed survey results are available in the CSAT Dashboard, custom dashboard CSAT widgets, report blocks and CSV exports, subject to company mapping and role access. You can keep using Autotask’s own surveys; Simplesat is not required.
Can I replace saved credentials by retesting the form?
A retest only verifies access. Select Save changes after testing the replacement credentials, then confirm the saved connection before revoking the old credential.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"MSPortal.ai Documentation","colors":{"primary":"#0C8376","light":"#15B79E","dark":"#107569"},"logo":{"light":"https://mintcdn.com/msportal/KnbwIXtZSTlVJTt6/logo/light.svg?fit=max\u0026auto=format\u0026n=KnbwIXtZSTlVJTt6\u0026q=85\u0026s=eb69f6d6bf16b2c401770aef19ade1d2","dark":"https://mintcdn.com/msportal/KnbwIXtZSTlVJTt6/logo/dark.svg?fit=max\u0026auto=format\u0026n=KnbwIXtZSTlVJTt6\u0026q=85\u0026s=03f8df7191e7a8ea7da084df57f6107f"},"favicon":"https://mintcdn.com/msportal/KjsKytvp08K0bejm/favicon-16x16.png?fit=max\u0026auto=format\u0026n=KjsKytvp08K0bejm\u0026q=85\u0026s=378df7f039bbff7885231fec799d29ac","navbar":{"links":[{"href":"/release-notes/roadmap","label":"Roadmap"},{"href":"mailto:support@msportal.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.msportal.ai"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/msportal"},"links":[{"header":"Resources","items":[{"label":"MSPortal.ai","href":"https://msportal.ai"},{"label":"Support","href":"mailto:support@msportal.ai"},{"label":"Status","href":"https://status.msportal.ai"}]}]},"fonts":{"family":"Inter"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"msportal","hasAudioNarration":false,"actualSubdomain":"msportal","customDomains":["docs.msportal.ai"],"gitSource":{"type":"github","owner":"msportal-ai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afce646a2091cf665e5fec4","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"MSP Guides","count":473},{"language":"default","tag":"API Reference","count":433},{"language":"default","tag":"Operations","count":128},{"language":"default","tag":"Planning","count":101},{"language":"default","tag":"Integrations","count":96},{"language":"default","tag":"Projects","count":76},{"language":"default","tag":"Protection","count":59},{"language":"default","tag":"Standards","count":56},{"language":"default","tag":"Client Onboarding","count":48},{"language":"default","tag":"Compliance","count":45}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#page-title{font-size:1.75rem;line-height:2.125rem}#header .prose.text-lg{font-size:1rem;line-height:1.5rem;color:rgb(var(--gray-500))}#content-area .prose{font-size:0.9375rem;line-height:1.6}#content-area .mdx-content{margin-top:1.5rem}#content-area .mdx-content h2{font-size:1.25rem;line-height:1.75rem;margin-top:2.25rem;margin-bottom:0.75rem}#content-area .mdx-content h3{font-size:1.0625rem;line-height:1.5rem;margin-top:1.75rem;margin-bottom:0.5rem}#content-area .mdx-content li{margin-top:0.25em;margin-bottom:0.25em}#content-area .steps{margin-top:1rem}#content-area .step{padding-bottom:0.75rem}#content-area [data-component-part=\"step-title\"]{margin-top:0.25rem;margin-bottom:0.375rem}#content-area [data-component-part=\"accordion-content\"] td,#content-area [data-component-part=\"accordion-content\"] th{min-width:0}@media (max-width: 639px){#content-area [data-component-part=\"accordion-content\"] td:last-child{min-width:16rem}}#content-area [data-table-wrapper]>[data-component-part=\"scroll-area-viewport\"]{-webkit-mask-image:linear-gradient(\n to right,\n transparent 0,\n black min(var(--scroll-area-fade-size), var(--scroll-area-overflow-x-start, 0px)),\n black calc(100% - min(var(--scroll-area-fade-size), var(--scroll-area-overflow-x-end, 0px))),\n transparent 100%\n );mask-image:linear-gradient(\n to right,\n transparent 0,\n black min(var(--scroll-area-fade-size), var(--scroll-area-overflow-x-start, 0px)),\n black calc(100% - min(var(--scroll-area-fade-size), var(--scroll-area-overflow-x-end, 0px))),\n transparent 100%\n )}#content-area [data-table-wrapper]>[data-component-part=\"scroll-area-scrollbar\"][data-has-overflow-x]{opacity:1;pointer-events:auto}#sidebar-content li>a,#sidebar-content li>button{font-size:0.875rem;line-height:1.25rem;padding-top:0.3125rem;padding-bottom:0.3125rem}#sidebar-content li>a span{hyphens:manual}#sidebar-content a.nav-anchor{margin-bottom:0.25rem;font-size:0.875rem}#sidebar-content ul:has(>li>a.nav-anchor){margin-bottom:1rem;padding-bottom:0.5rem;border-bottom:1px solid rgb(var(--gray-100))}.dark #sidebar-content ul:has(>li>a.nav-anchor){border-bottom-color:rgb(255 255 255 / 0.1)}#table-of-contents{font-size:0.8125rem;line-height:1.25rem}#sidebar-content li>a>div:first-child:has(>svg,>img){display:none}:root{--sidebar-width: 16rem}@media (min-width: 1024px){#navbar .max-w-8xl,#body-content{max-width:none}#content-container{max-width:88rem;margin-left:0;padding-left:2.5rem;padding-right:2rem;column-gap:2.5rem;justify-content:space-between}}@media (min-width: 1280px){#content-area{width:calc(100% - 16.5rem);max-width:52rem;margin-left:0}#navbar.is-wide~#body-content #content-container{max-width:none}#navbar.is-wide~#body-content #content-area{width:100%;max-width:none}#table-of-contents-layout{width:14rem;padding-left:0}#table-of-contents{width:14rem}}.roadmap-embed{display:block;border:0;background:transparent;color-scheme:light}.dark .roadmap-embed{color-scheme:dark}#content-area img[width=\"390\"],#content-area img[width=\"780\"]{width:100%!important;max-width:300px!important;height:auto!important;margin-left:auto;margin-right:auto}"}],"page":{"pagePath":"user-guides/integrations/enable-autotask-integration","slug":"/user-guides/integrations/enable-autotask-integration","pageMetadata":{"title":"Configure Autotask PSA Integration","description":"Connect Autotask PSA, import native survey results for CSAT dashboards and reports, and choose data scope","icon":"plug","href":"/user-guides/integrations/enable-autotask-integration"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect Autotask PSA, import native survey results for CSAT dashboards and reports, and choose data scope\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,Frame,Heading,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This guide walks you through connecting your Autotask PSA instance to MSPortal.ai. MSP staff set up the connection; company users do not administer it. You connect, check permissions, choose data and match records on the Autotask connection page.`}),`\n`,_jsxs(_components.p,{children:[`MSPortal can also import `,_jsx(_components.strong,{children:`Autotask native survey results`}),` into the `,_jsx(_components.strong,{children:`CSAT Dashboard`}),`, custom dashboard widgets, report blocks and CSV exports. The import is off by default, and you can keep collecting feedback through Autotask’s own surveys. See `,_jsx(_components.a,{href:`#import-autotask-native-csat-for-dashboards-and-reports`,children:`Import Autotask native CSAT for dashboards and reports`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Admin access to Autotask, or API credentials (username and secret)`}),`\n`,_jsx(_components.li,{children:`Admin access to MSPortal.ai with integration management permissions`}),`\n`,_jsx(_components.li,{children:`The Ticket Settings permission in MSPortal if you will edit ticket defaults`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`part-1-configure-autotask-psa`,children:`Part 1: Configure Autotask PSA`}),`\n`,_jsxs(_components.p,{children:[`Before connecting to MSPortal.ai, you need to create an API user and security role in Autotask. See Autotask’s `,_jsx(_components.a,{href:`https://autotask.net/help/developerhelp/content/apis/General/Define_API_User.htm`,children:`API user setup`}),` and `,_jsx(_components.a,{href:`https://www.autotask.net/help/DeveloperHelp/Content/APIs/REST/General_Topics/REST_Security_Auth.htm`,children:`REST authentication`}),` guides for background.`]}),`\n`,_jsx(Heading,{level:`3`,id:`create-security-role`,children:`Create Security Role`}),`\n`,_jsx(_components.p,{children:`MSPortal signs in to Autotask as one API user. That user can do exactly what its security level allows, so start from Autotask’s API level, remove what MSPortal never uses, and keep what it does.`}),`\n`,_jsx(Card,{title:`See the MSPortal security level (PDF)`,icon:`file-pdf`,href:`/files/autotask-msportal-security-level.pdf`,children:_jsx(_components.p,{children:`Every section of the security level, as exported from Autotask. It grants more than MSPortal needs in a few areas, such as Inventory. Where it differs from the tables below, follow the tables.`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Security Levels`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Sign in to `,_jsx(_components.a,{href:`https://ww2.autotask.net`,children:`Autotask`}),` as a user with HR admin rights`]}),`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.strong,{children:`Admin`}),` > `,_jsx(_components.strong,{children:`Account Settings \u0026 Users`})]}),`\n`,_jsxs(_components.li,{children:[`Expand `,_jsx(_components.strong,{children:`Resources/Users (HR)`}),` and open `,_jsx(_components.strong,{children:`Security Levels`})]}),`\n`]})}),_jsxs(Step,{title:`Copy the API-only level`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open the menu beside `,_jsx(_components.strong,{children:`API User (system) (API-only)`}),` and select `,_jsx(_components.strong,{children:`Copy`}),`. Autotask does not let you edit the system level itself.`]}),`\n`,_jsxs(_components.li,{children:[`Rename the copy to `,_jsx(_components.strong,{children:`MSPortal`}),`.`]}),`\n`]}),_jsx(_components.p,{children:`The copy starts with full access to everything, including deleting records. The next two steps trim it.`})]}),_jsxs(Step,{title:`Remove what MSPortal never uses`,children:[_jsxs(_components.p,{children:[`MSPortal never deletes your Autotask records, so the biggest cut is `,_jsx(_components.strong,{children:`Delete`}),`. Then switch off the areas it does not touch.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Where`}),_jsx(_components.th,{children:`Change`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Every section`}),_jsxs(_components.td,{children:[`Set every `,_jsx(_components.strong,{children:`Delete`}),` to `,_jsx(_components.strong,{children:`None`}),`. The one exception is `,_jsx(_components.strong,{children:`Service Desk`}),` > `,_jsx(_components.strong,{children:`Service Calls`}),`, and only when you book work from `,_jsx(_components.strong,{children:`Projects`}),` > `,_jsx(_components.strong,{children:`Dispatch`}),` in MSPortal.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Documents \u0026 Knowledge Base`})}),_jsxs(_components.td,{children:[`Select `,_jsx(_components.strong,{children:`No Permission`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Reports`})}),_jsxs(_components.td,{children:[`Select `,_jsx(_components.strong,{children:`No Permission`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Projects`}),` and `,_jsx(_components.strong,{children:`Service Desk`})]}),_jsxs(_components.td,{children:[`On the `,_jsx(_components.strong,{children:`Expenses`}),` row, set View to `,_jsx(_components.strong,{children:`None`}),`, Add to `,_jsx(_components.strong,{children:`No`}),` and Edit to `,_jsx(_components.strong,{children:`None`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Inventory`})}),_jsxs(_components.td,{children:[`Set every row except `,_jsx(_components.strong,{children:`Products`}),` to `,_jsx(_components.strong,{children:`None`}),` and `,_jsx(_components.strong,{children:`No`}),`, and clear every box under `,_jsx(_components.strong,{children:`Feature Access`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contracts`})}),_jsxs(_components.td,{children:[`Set `,_jsx(_components.strong,{children:`Can Approve \u0026 Post`}),` and `,_jsx(_components.strong,{children:`Can Invoice`}),` to `,_jsx(_components.strong,{children:`None`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`CRM`})}),_jsxs(_components.td,{children:[`Clear every box under `,_jsx(_components.strong,{children:`Feature Access`}),` and `,_jsx(_components.strong,{children:`Opportunity Checklist Permissions`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Admin`})}),_jsxs(_components.td,{children:[`Clear every box except the ones listed under `,_jsx(_components.strong,{children:`Admin`}),` in the next step. Make sure `,_jsx(_components.strong,{children:`Application-Wide (Shared) Features (Full Access)`}),` is clear.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Other`})}),_jsxs(_components.td,{children:[`Clear every box under `,_jsx(_components.strong,{children:`Dashboard`}),`, `,_jsx(_components.strong,{children:`Client Portal`}),`, `,_jsx(_components.strong,{children:`Community Online`}),` and `,_jsx(_components.strong,{children:`Miscellaneous`})]})]})]})]})]}),_jsxs(Step,{title:`Keep what MSPortal uses`,children:[_jsxs(_components.p,{children:[`Check that the rows below are set as shown. A row marked `,_jsx(_components.em,{children:`Optional`}),` is needed only for the feature it names; the rest of the integration works without it. Where a row offers `,_jsx(_components.strong,{children:`All`}),` or `,_jsx(_components.strong,{children:`Mine`}),`, use `,_jsx(_components.strong,{children:`All`}),`: `,_jsx(_components.strong,{children:`Mine`}),` limits the API user to records assigned to it, so syncs miss records and updates to other people’s work fail.`]}),_jsxs(_components.p,{children:[`Autotask has renamed some labels between releases. `,_jsx(_components.strong,{children:`Accounts`}),` may show as `,_jsx(_components.strong,{children:`Organizations`}),`, and `,_jsx(_components.strong,{children:`Configuration Items`}),` as `,_jsx(_components.strong,{children:`Devices`}),`. Use whichever your screen shows.`]}),_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Service Desk`,id:`service-desk`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Set to`}),_jsx(_components.th,{children:`Used for`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Tickets`}),`: View`]}),_jsx(_components.td,{children:`All`}),_jsx(_components.td,{children:`Sync tickets, their notes and attachments`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Tickets`}),`: Add`]}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Create the tickets people submit in MSPortal. With this set to No, every submission is emailed to your fallback inbox instead.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Tickets`}),`: Edit`]}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Change status when a client replies, closes or reopens a ticket, and write mapped fields`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Service Calls`}),`: View`]}),_jsx(_components.td,{children:`All`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to show service calls on the calendar`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Service Calls`}),`: Add, Edit, Delete`]}),_jsx(_components.td,{children:`Yes, Yes, All`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to create, move and remove service calls when you book work from `,_jsx(_components.strong,{children:`Projects`}),` > `,_jsx(_components.strong,{children:`Dispatch`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Can view non-billable time entries`})}),_jsx(_components.td,{children:`On`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to count non-billable time when time entries sync`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Can modify Non-Billable setting on ticket time entries`})}),_jsx(_components.td,{children:`On`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used when staff log ticket time from MSPortal and mark it billable or non-billable`]})]})]})]})}),_jsx(Accordion,{title:`CRM`,id:`crm`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Set to`}),_jsx(_components.th,{children:`Used for`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Customer \u0026 Cancelation`})}),_jsx(_components.td,{children:`All`}),_jsx(_components.td,{children:`Sync your client organizations, their locations and contacts`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Vendor \u0026 Partners`}),` and `,_jsx(_components.strong,{children:`Prospects, Leads, \u0026 Dead`})]}),_jsx(_components.td,{children:`All`}),_jsx(_components.td,{children:`Set to None if you do not want those organization types in MSPortal`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Accounts`}),`: Edit`]}),_jsx(_components.td,{children:`All`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used by `,_jsx(_components.a,{href:`/user-guides/msp-tools/traffic-light-review`,children:`Traffic Light Review`}),`, a pilot feature, to write a customer’s status to organization fields and a company alert. Otherwise set it to None.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Notes`}),`: Add, Edit`]}),_jsx(_components.td,{children:`Yes, All`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to save account notes written in MSPortal to Autotask`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Opportunities \u0026 Quotes`}),`: View`]}),_jsx(_components.td,{children:`All`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to sync opportunities`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Opportunities \u0026 Quotes`}),`: Add`]}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to create an Autotask opportunity from an MSPortal quote. Also tick `,_jsx(_components.strong,{children:`Can modify Opportunity Owner (reassign Opportunities)`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Configuration Items \u0026 Subscriptions`}),`: View`]}),_jsx(_components.td,{children:`All`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to import devices from Autotask`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Configuration Items \u0026 Subscriptions`}),`: Edit`]}),_jsx(_components.td,{children:`All`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to write warranty dates to devices with `,_jsx(_components.a,{href:`/user-guides/integrations/autotask-warranty-writeback`,children:`warranty writeback`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Attachments`}),`: View, Add`]}),_jsx(_components.td,{children:`All, Yes`}),_jsx(_components.td,{children:`Read and upload attachments`})]})]})]})}),_jsxs(Accordion,{title:`Contracts`,id:`contracts`,children:[_jsx(_components.p,{children:`Skip this section unless you sync contracts or invoices.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Set to`}),_jsx(_components.th,{children:`Used for`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Contracts`}),`: View`]}),_jsx(_components.td,{children:`All`}),_jsx(_components.td,{children:`Sync contracts, their services and charges`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contract Visibility`})}),_jsx(_components.td,{children:`Full`}),_jsx(_components.td,{children:`Read the services, bundles and charges on each contract`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Can access Invoice History, (Invoice) Export Wizard and Payments`})}),_jsx(_components.td,{children:`On`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to sync invoices. With this clear, Autotask refuses to list invoices.`]})]})]})]})]}),_jsx(Accordion,{title:`Inventory`,id:`inventory`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Set to`}),_jsx(_components.th,{children:`Used for`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Products`}),`: View`]}),_jsx(_components.td,{children:`All`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to sync the product catalog`]})]})})]})}),_jsxs(Accordion,{title:`Projects`,id:`projects`,children:[_jsxs(_components.p,{children:[`Skip this section unless you use Autotask projects in MSPortal. See `,_jsx(_components.a,{href:`#project-management-permissions`,children:`Project management permissions`}),` for the project-specific checks.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Set to`}),_jsx(_components.th,{children:`Used for`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Client \u0026 Internal`}),`: View`]}),_jsx(_components.td,{children:`All`}),_jsx(_components.td,{children:`Sync projects, phases, tasks and time entry notes. Autotask lets anyone who can view a project also edit it, so this row also covers changing status, owner, dates and mapped fields from MSPortal.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Client \u0026 Internal`}),`: Add`]}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to create Autotask projects from MSPortal, including from templates`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Project Templates`}),`: View`]}),_jsx(_components.td,{children:`All`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to import Autotask project templates`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Can enter time on`})}),_jsx(_components.td,{children:`All Tasks`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to log time against project tasks`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Can modify Non-Billable setting on task and issue time entries`})}),_jsx(_components.td,{children:`On`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used when staff mark project time billable or non-billable`]})]})]})]})]}),_jsxs(Accordion,{title:`Admin`,id:`admin`,children:[_jsx(_components.p,{children:`Autotask keeps its setup lists behind these Admin areas. MSPortal reads them and changes nothing. Keep these ten and clear every other box in the section.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Set to`}),_jsx(_components.th,{children:`Used for`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Your Organization`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Your company’s locations and settings`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Resources/Users (HR)`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Staff, roles and departments, to match staff and fill assignment lists`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Accounts \u0026 Contacts`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Organization types and classifications`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Service Desk (Tickets)`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Queues, statuses, priorities, issue types and ticket categories`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Projects \u0026 Tasks`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Project and task setup lists`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sales \u0026 Opportunities`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Opportunity stages and categories`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Products, Services, \u0026 Inventory`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Products, services and work types`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Configuration Items`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Device types and categories. With this clear, device import cannot read them.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Finance, Accounting, \u0026 Invoicing`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Payment terms and invoice setup`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contracts \u0026 Un-Posting`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Contract setup lists`})]})]})]})]}),_jsx(Accordion,{title:`Other`,id:`other`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Set to`}),_jsx(_components.th,{children:`Used for`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Can create Webhooks`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Ticket and note changes reach MSPortal within seconds`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Maximum number of Webhooks`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`25`}),_jsx(_components.td,{children:`Room for the ticket and ticket note webhooks`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Can view Account Survey Ratings and Contact Survey Ratings`})}),_jsx(_components.td,{children:`On`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to `,_jsx(_components.a,{href:`#import-autotask-native-csat-for-dashboards-and-reports`,children:`import Autotask CSAT`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Can view Resource Survey Ratings`})}),_jsx(_components.td,{children:`On`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Optional:`}),` Used to import Autotask CSAT`]})]})]})]})}),_jsxs(Accordion,{title:`Web Services API`,id:`web-services-api`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Set to`}),_jsx(_components.th,{children:`Used for`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Can login to Web Services API`})}),_jsx(_components.td,{children:`On`}),_jsx(_components.td,{children:`Required. Without it the API user cannot connect.`})]})})]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Resource Impersonation`}),` lets MSPortal add tickets, notes and time on behalf of a staff member, so Autotask shows that person as the author instead of the API user. Tick these boxes and leave every `,_jsx(_components.strong,{children:`Delete`}),` box clear:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Section`}),_jsx(_components.th,{children:`Objects`}),_jsx(_components.th,{children:`Boxes to tick`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contracts`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contract Notes`})}),_jsx(_components.td,{children:`View, Add, Edit`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`CRM`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Opportunities \u0026 Quotes`}),`, `,_jsx(_components.strong,{children:`Notes`}),`, `,_jsx(_components.strong,{children:`Configuration Items \u0026 Subscriptions`}),`, `,_jsx(_components.strong,{children:`Configuration Item Notes`})]}),_jsx(_components.td,{children:`View, Add, Edit`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Projects`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Projects`}),`, `,_jsx(_components.strong,{children:`Project Notes`}),`, `,_jsx(_components.strong,{children:`Task Notes`})]}),_jsx(_components.td,{children:`View, Add, Edit`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Service Desk`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Tickets`}),`, `,_jsx(_components.strong,{children:`Ticket Notes`}),`, `,_jsx(_components.strong,{children:`Service Calls`})]}),_jsx(_components.td,{children:`View, Add, Edit`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Other/Shared`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Attachments`})}),_jsx(_components.td,{children:`View, Add`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Other/Shared`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Time Entries`})}),_jsx(_components.td,{children:`View, Add, Edit`})]})]})]}),_jsxs(_components.p,{children:[`Leave `,_jsx(_components.strong,{children:`Accounts`}),`, `,_jsx(_components.strong,{children:`Contact`}),`, `,_jsx(_components.strong,{children:`Sales Orders`}),`, `,_jsx(_components.strong,{children:`To-Dos`}),`, every `,_jsx(_components.strong,{children:`Inventory`}),` row and the two time off boxes clear. Autotask also requires the security level of each staff member MSPortal acts for to allow impersonation.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Contact Impersonation`}),` lets the API user add items on behalf of a client contact. Tick `,_jsx(_components.strong,{children:`Add`}),` on `,_jsx(_components.strong,{children:`Project Notes`}),`, `,_jsx(_components.strong,{children:`Task Notes`}),`, `,_jsx(_components.strong,{children:`Tickets`}),`, `,_jsx(_components.strong,{children:`Ticket Notes`}),` and `,_jsx(_components.strong,{children:`Attachments`}),`.`]}),_jsx(_components.p,{children:`When a staff member has no linked Autotask resource, MSPortal adds the note as the API user and puts their name in the note title.`})]})]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`Turning a feature on later? Set its rows here first, then select `,_jsx(_components.strong,{children:`Re-check`}),` on the connection’s `,_jsx(_components.strong,{children:`Permissions`}),` task in MSPortal.`]})})]}),_jsx(Step,{title:`Save the Role`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save \u0026 Close`}),`.`]})})]}),`\n`,_jsxs(_components.p,{children:[`After you connect, the `,_jsx(_components.strong,{children:`Permissions`}),` task in MSPortal checks this level from Autotask’s side: each area MSPortal reads, and whether the API user may create and update tickets. It names the setting to change for anything missing. See `,_jsx(_components.a,{href:`#permissions`,children:`Permissions`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`create-api-user`,children:`Create API User`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Navigate to Users`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Go back to `,_jsx(_components.strong,{children:`Account Settings \u0026 Users`})]}),`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`Resources/Users`})]}),`\n`,_jsxs(_components.li,{children:[`Click to add a new `,_jsx(_components.strong,{children:`API user`})]}),`\n`]})}),_jsxs(Step,{title:`Configure API User`,children:[_jsx(_components.p,{children:`Fill in the following details:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`First Name`})}),_jsx(_components.td,{children:`MSPortal`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Last Name`})}),_jsx(_components.td,{children:`Integration`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Security Level`})}),_jsx(_components.td,{children:`MSPortal (the role you created)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Email Address`})}),_jsx(_components.td,{children:`Use an internal alias for receiving integration logs`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Primary Internal Location`})}),_jsx(_components.td,{children:`Select your headquarters`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Integration Vendor`})}),_jsx(_components.td,{children:`MSPortal.ai`})]})]})]}),_jsx(_components.p,{children:`The MSPortal connection form asks only for the API username and secret. It has no field for a custom tracking identifier, so set the integration vendor here. If Autotask rejects the tracking identifier, confirm the vendor association with your Autotask administrator.`})]}),_jsxs(Step,{title:`Generate API Credentials`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`Credentials`}),`, click `,_jsx(_components.strong,{children:`Generate Key`})]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Generate Secret`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Important:`}),` Save the API username and secret immediately. The secret cannot be retrieved later.`]}),`\n`]}),_jsx(Warning,{children:_jsx(_components.p,{children:`Make sure to copy and save your API credentials before closing this dialog. The secret cannot be viewed again after creation.`})})]}),_jsx(Step,{title:`Associate Lines of Business`,children:_jsxs(_components.p,{children:[`Associate the appropriate lines of business with the API user, then click `,_jsx(_components.strong,{children:`Save \u0026 Close`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`project-management-permissions`,children:`Project management permissions`}),`\n`,_jsxs(_components.p,{children:[`Skip this section unless you create or update Autotask projects from MSPortal. Syncing projects needs only the `,_jsx(_components.strong,{children:`View`}),` row under `,_jsx(_components.strong,{children:`Projects`}),` in `,_jsx(_components.a,{href:`#create-security-role`,children:`Create Security Role`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`These settings go on the security level of the `,_jsx(_components.strong,{children:`API user whose credentials are saved in MSPortal`}),`. A technician’s own security level does not give the integration any access.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Grant project access`,children:[_jsxs(_components.p,{children:[`In Autotask, go to `,_jsx(_components.strong,{children:`Admin`}),` > `,_jsx(_components.strong,{children:`Account Settings \u0026 Users`}),` > `,_jsx(_components.strong,{children:`Resources/Users (HR)`}),` > `,_jsx(_components.strong,{children:`Security Levels`}),`, edit the `,_jsx(_components.strong,{children:`MSPortal`}),` level and open `,_jsx(_components.strong,{children:`Projects`}),`. Autotask treats project tasks separately from service tickets, so Service Desk ticket access alone is not enough.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`What you do in MSPortal`}),_jsx(_components.th,{children:`Rows it needs under Projects`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`See projects, phases, tasks and time entry notes`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Client \u0026 Internal`}),`: View set to All`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Change status, owner, priority, dates, estimated hours or mapped fields`}),_jsx(_components.td,{children:`The same View row. Autotask lets anyone who can view a project also edit it, so there is no separate Edit setting.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create projects, phases and tasks, including from templates`}),_jsxs(_components.td,{children:[`View, and `,_jsx(_components.strong,{children:`Client \u0026 Internal`}),`: Add set to Yes`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Log time against project tasks`}),_jsxs(_components.td,{children:[`View, and `,_jsx(_components.strong,{children:`Can enter time on`}),` set to All Tasks`]})]})]})]}),_jsx(_components.p,{children:`Three things to check while you are there:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Line of Business.`}),` Autotask can hide projects and tasks by Line of Business even with View set to All, so include every Line of Business the integration should see.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Time entries.`}),` The API user must be allowed to enter time for the resource the time belongs to. Enable the billing field permissions if staff set billable or non-billable time.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No deletes.`}),` MSPortal never deletes a project, phase or task. Keep `,_jsx(_components.strong,{children:`Delete`}),` at None on the `,_jsx(_components.strong,{children:`Task Notes`}),` and `,_jsx(_components.strong,{children:`Charges`}),` rows.`]}),`\n`]}),_jsxs(_components.p,{children:[`Baseline project tasks stay read-only, and Autotask’s rules for completed tasks and submitted or posted time still apply. See Autotask’s `,_jsx(_components.a,{href:`https://www.autotask.net/help/Developerhelp/Content/APIs/REST/Entities/TasksEntity.htm`,children:`task access rules`}),` and `,_jsx(_components.a,{href:`https://ww2.autotask.net/help/developerhelp/Content/APIs/REST/Entities/TimeEntriesEntity.htm`,children:`time entry requirements`}),`.`]})]}),_jsx(Step,{title:`Save and re-check`,children:_jsxs(_components.p,{children:[`Save the security level. In MSPortal, go to `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Integrations`}),`, open the Autotask PSA connection, select `,_jsx(_components.strong,{children:`Permissions`}),` and click `,_jsx(_components.strong,{children:`Re-check`}),`.`]})}),_jsx(Step,{title:`Test on a project`,children:_jsxs(_components.p,{children:[`A green `,_jsx(_components.strong,{children:`Projects`}),` result only confirms MSPortal can read projects. Create a test project, edit a task and log time on it to confirm write access. If applying a template partly succeeds, check the records it created before you retry. An Autotask administrator can also inspect the API user’s effective access with Autotask’s `,_jsx(_components.a,{href:`https://www.autotask.net/help/Developerhelp/Content/APIs/REST/API_Calls/REST_EntityInformationCall.htm`,children:`entityInformation permissions`}),`.`]})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`In MSPortal, Autotask project task notes are `,_jsx(_components.strong,{children:`time entry notes`}),`. Standalone project task notes and editable checklist items are not available for Autotask, and extra Autotask permissions will not turn them on. MSPortal-only projects and templates use MSPortal permissions only.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`what-msportal-writes-back-to-autotask-projects`,children:`What MSPortal writes back to Autotask projects`}),`\n`,_jsx(_components.p,{children:`Autotask projects are two-way for status and dates. You do not need to repeat these changes in Autotask:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Project status`}),`, from the portfolio `,_jsx(_components.strong,{children:`Kanban`}),` or the project’s status.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Task status`}),`, from the project `,_jsx(_components.strong,{children:`Board`}),` or ticket details.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Task owner`}),`, from the `,_jsx(_components.strong,{children:`Resources`}),` board or the project `,_jsx(_components.strong,{children:`Board`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Project, phase and task dates`}),`, from `,_jsx(_components.strong,{children:`Reschedule`}),`, `,_jsx(_components.strong,{children:`Edit dates`}),`, `,_jsx(_components.strong,{children:`Projects > Dispatch`}),`, or ticket and phase details. An Autotask phase date change needs both a start date and an end date.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`MSPortal writes to Autotask first and updates its own copy only after Autotask accepts the change. If Autotask rejects it, MSPortal shows an error and keeps the old value.`}),`\n`,_jsxs(_components.p,{children:[`Some changes stay in MSPortal. Rename phases in Autotask, because MSPortal does not send phase renames. Phase descriptions and notes, milestones, and project and onboarding templates stay in MSPortal. Onboarding task status syncs with Autotask, and an onboarding task due date changed in the portal is written to the linked Autotask task. Onboarding phase dates stay in MSPortal. See `,_jsx(_components.a,{href:`/user-guides/projects/index#what-writes-back-to-your-psa`,children:`What writes back to your PSA`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`part-2-connect-autotask-in-msportal`,children:`Part 2: Connect Autotask in MSPortal`}),`\n`,_jsxs(_components.p,{children:[`The Autotask connection page lists its setup tasks in the `,_jsx(_components.strong,{children:`Setup guide`}),`: `,_jsx(_components.strong,{children:`Connect`}),`, `,_jsx(_components.strong,{children:`Permissions`}),`, `,_jsx(_components.strong,{children:`Choose data`}),`, `,_jsx(_components.strong,{children:`Import or match companies`}),`, `,_jsx(_components.strong,{children:`Import or match users`}),`, `,_jsx(_components.strong,{children:`Import devices`}),`, `,_jsx(_components.strong,{children:`Configure tickets`}),`, `,_jsx(_components.strong,{children:`Configure opportunities`}),` and `,_jsx(_components.strong,{children:`Review`}),`. `,_jsx(_components.strong,{children:`Import or match users`}),`, `,_jsx(_components.strong,{children:`Import devices`}),` and `,_jsx(_components.strong,{children:`Configure opportunities`}),` are optional. Select a task to return to it at any time.`]}),`\n`,_jsx(Heading,{level:`3`,id:`open-the-connection`,children:`Open the connection`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Navigate to Integrations`,children:_jsxs(_components.p,{children:[`In MSPortal.ai, go to `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Integrations`}),`.`]})}),_jsx(Step,{title:`Start Setup`,children:_jsxs(_components.p,{children:[`Find `,_jsx(_components.strong,{children:`Autotask PSA`}),` and select `,_jsx(_components.strong,{children:`Connect`}),`. To continue an existing setup, open the existing Autotask PSA connection instead.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`connect`,children:`Connect`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Enter API Credentials`,children:[_jsx(_components.p,{children:`Fill in the following fields:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API username`})}),_jsxs(_components.td,{children:[`Your Autotask API user email (e.g., `,_jsx(_components.code,{children:`api.user@yourdomain.com`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API secret`})}),_jsx(_components.td,{children:`The API secret generated for your API user`})]})]})]})]}),_jsxs(Step,{title:`Test the connection`,children:[_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Test connection`}),` and resolve any reported error. A successful test does not save the connection.`]}),_jsx(Note,{children:_jsx(_components.p,{children:`If the connection fails, verify your API username and secret are correct and that the API user has the MSPortal security role assigned.`})})]}),_jsx(Step,{title:`Save and continue`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Save and continue`}),` to create the connection, then continue to `,_jsx(_components.strong,{children:`Permissions`}),`.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`permissions`,children:`Permissions`}),`\n`,_jsxs(_components.p,{children:[`MSPortal checks what your Autotask API user is allowed to read, and whether it may create and update tickets, and shows the result for each area. The check only reads your security level; it never creates or changes anything. If the check has not run yet, select `,_jsx(_components.strong,{children:`Run check`}),`.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Review the results`,children:[_jsxs(_components.p,{children:[`Each area of data is listed as `,_jsx(_components.strong,{children:`Granted`}),`, `,_jsx(_components.strong,{children:`Not permitted`}),` or `,_jsx(_components.strong,{children:`Could not verify`}),`.`]}),_jsxs(_components.p,{children:[`Areas marked `,_jsx(_components.strong,{children:`Required`}),` must be granted before you can continue: Companies, Contacts and staff, Tickets, and Queues and statuses. Without these the integration cannot function.`]}),_jsx(_components.p,{children:`Other areas cover Ticket creation and updates, Configurations, Opportunities, Product catalog, Invoices, Contracts, Projects, Time entries, Service calls, Company notes, and Satisfaction feedback. You can continue and fix them later.`}),_jsxs(_components.p,{children:[`If `,_jsx(_components.strong,{children:`Ticket creation and updates`}),` is `,_jsx(_components.strong,{children:`Not permitted`}),`, the API user can read tickets but its security level has `,_jsx(_components.strong,{children:`Tickets`}),` Add or Edit set to `,_jsx(_components.strong,{children:`No`}),` under `,_jsx(_components.strong,{children:`Service Desk`}),`. Until you change it, tickets submitted in MSPortal are emailed to your fallback inbox, and the message says the PSA was unavailable.`]})]}),_jsxs(Step,{title:`Grant anything missing`,children:[_jsx(_components.p,{children:`Any area that is not permitted names the security level setting to change.`}),_jsxs(_components.p,{children:[`Update the security level assigned to your API user, then come back and click `,_jsx(_components.strong,{children:`Re-check`}),`. Every setting MSPortal uses is listed under `,_jsx(_components.a,{href:`#create-security-role`,children:`Create Security Role`}),`.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Could not verify`}),` usually means Autotask was slow or unavailable, not that a permission is missing. Click `,_jsx(_components.strong,{children:`Re-check`}),` before you change the security level.`]})})]}),_jsx(Step,{title:`Continue`,children:_jsxs(_components.p,{children:[`Optional areas that are not granted keep their syncs switched off, and their switches in `,_jsx(_components.strong,{children:`Choose data`}),` stay locked until you grant the permission and re-check.`]})})]}),`\n`,_jsxs(_components.p,{children:[`These checks test `,_jsx(_components.strong,{children:`read access`}),` only. A green result does not prove that ticket creation, comments, warranty updates or other writes will succeed.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`If a permission is removed later, MSPortal switches off the affected sync and notifies your integration admins rather than retrying against an entity it can no longer read.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`choose-data`,children:`Choose data`}),`\n`,_jsxs(_components.p,{children:[`Choose what data to sync from Autotask and set up automatic imports. Each switch and filter saves as you change it, so wait for the saved state before you leave. Switches sit side by side in two groups, `,_jsx(_components.strong,{children:`Core data`}),` (companies, users and tickets) and `,_jsx(_components.strong,{children:`Extended data`}),`. Turning on a dataset reveals its settings below that group; turning it off hides them without clearing saved choices. Each switch and selector has an (i) beside its name: hover over, tap or focus it to read what the setting does. Start the initial sync when it is offered. Options in later tasks can stay incomplete while it runs.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Choose datasets`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sync Users`})}),_jsx(_components.td,{children:`Sync user/contact data from Autotask`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sync Companies`})}),_jsx(_components.td,{children:`Sync company/account data from Autotask`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Enable Ticket Sync`})}),_jsx(_components.td,{children:`Sync tickets from Autotask`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Enable Opportunity Sync`})}),_jsx(_components.td,{children:`Sync opportunities from Autotask`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Enable Project Sync`})}),_jsxs(_components.td,{children:[`Sync projects from Autotask. Project templates and baselines stay out of the project list and its totals. To reuse a template, `,_jsx(_components.a,{href:`/user-guides/projects/templates#import-export-and-maintain`,children:`import it as an MSPortal template`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Enable Invoice Sync`})}),_jsx(_components.td,{children:`Sync invoices from Autotask`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sync product catalog`})}),_jsx(_components.td,{children:`Import the product and service catalog for quoting and budgets`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Enable configuration item sync`})}),_jsx(_components.td,{children:`Sync configuration items into device staging for reporting and import`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Enable change management`})}),_jsx(_components.td,{children:`Import Autotask changes into the change calendar`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Import satisfaction ratings`})}),_jsxs(_components.td,{children:[`Import completed Autotask survey results. See `,_jsx(_components.a,{href:`#import-autotask-native-csat-for-dashboards-and-reports`,children:`Import Autotask native CSAT`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Warranty writeback`})}),_jsxs(_components.td,{children:[`Write warranty expiration dates to Autotask configuration items. See `,_jsx(_components.a,{href:`#write-warranty-dates-back-to-autotask`,children:`Write warranty dates back to Autotask`}),`.`]})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`A switch appears locked when the permission check found that your API user cannot read that data. Grant the permission named beside it in Autotask, then select `,_jsx(_components.strong,{children:`Re-check`}),` in `,_jsx(_components.strong,{children:`Permissions`}),` to unlock it.`]})})]}),_jsxs(Step,{title:`Configure Contact Auto-Import`,children:[_jsx(_components.p,{children:`If you want contacts to be automatically imported when companies are added:`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Turn on `,_jsx(_components.strong,{children:`Contact Auto-Import`}),` to automatically create user accounts for active contacts`]}),`\n`,_jsxs(_components.li,{children:[`Select a `,_jsx(_components.strong,{children:`Default Role for Imported Contacts`}),` (e.g., Viewer)`]}),`\n`,_jsxs(_components.li,{children:[`Optionally, under `,_jsx(_components.strong,{children:`Portal roles by contact type`}),`, select `,_jsx(_components.strong,{children:`Add rule`}),` to give specific Autotask contact types other portal roles. Unmapped types use the default role.`]}),`\n`]}),_jsx(Tip,{children:_jsx(_components.p,{children:`We recommend choosing a role with minimal permissions (basic ticket creation only) if you plan to import all contacts.`})}),_jsxs(_components.p,{children:[`To create portal users from your clients’ Microsoft 365 tenants instead, use an access rule with the action `,_jsx(_components.strong,{children:`Import Microsoft 365 users`}),` (branch preview). See `,_jsx(_components.a,{href:`/user-guides/settings/users-roles#set-access-rules`,children:`Set access rules`}),`.`]})]}),_jsxs(Step,{title:`Deactivate contacts with Microsoft 365 (optional)`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Deactivate the contact when Microsoft 365 disables the person`}),` (preview; appears once MSPortal turns it on for your MSP): with `,_jsx(_components.strong,{children:`Sync Users`}),` on, this switch sits below `,_jsx(_components.strong,{children:`Contact Auto-Import`}),`. When Microsoft 365 blocks a client user’s sign-in and MSPortal disables that user, MSPortal marks each of their linked, active Autotask contacts inactive, so the person can no longer open or reply to tickets by email. When Microsoft 365 enables the person again, MSPortal reactivates exactly the contacts it deactivated.`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`It applies to people Microsoft 365 disables after you turn it on. People who are already disabled are left alone.`}),`\n`,_jsx(_components.li,{children:`A contact that was already inactive is never recorded, so MSPortal never reactivates a contact you deactivated yourself.`}),`\n`,_jsx(_components.li,{children:`Disabling someone yourself in MSPortal, or for any reason other than Microsoft 365, never changes their Autotask contact.`}),`\n`,_jsx(_components.li,{children:`It needs a Microsoft 365 connection. Changes are sent after each Microsoft 365 users sync, and a failed change is retried up to five times.`}),`\n`,_jsx(_components.li,{children:`Turning it off stops new deactivations. Contacts MSPortal already deactivated are still reactivated when Microsoft 365 enables the person.`}),`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.strong,{children:`Recent contact changes`}),` button below the switch opens a dialog listing each contact MSPortal changed, and why one was left alone or failed. It refreshes while open. The button needs read access to company users. The API user must be allowed to edit Autotask contacts; a refusal shows there.`]}),`\n`]})]}),_jsx(Step,{title:`Configure Company Auto-Import and Filters`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Auto-Import Company Types`})}),_jsx(_components.td,{children:`Companies of the selected types are created in the portal automatically during sync. MSPortal asks you to confirm before it imports a new batch, because companies are a billed item.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Exclude Company Types`})}),_jsx(_components.td,{children:`Select company types to exclude from sync`})]})]})]})}),_jsxs(Step,{title:`Configure Ticket Sync Scope`,children:[_jsxs(_components.p,{children:[`With `,_jsx(_components.strong,{children:`Enable Ticket Sync`}),` on, define which tickets to sync:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sync recurring tickets`})}),_jsx(_components.td,{children:`Include tickets generated from Autotask recurring ticket templates`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Queues to Sync`})}),_jsx(_components.td,{children:`Select which Autotask queues’ tickets to sync`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Exclude Statuses`})}),_jsx(_components.td,{children:`Select ticket statuses to exclude from sync`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Categories`})}),_jsx(_components.td,{children:`Select the ticket categories to sync, or leave it empty to sync every category. Categories added in Autotask later stay unselected until you add them; the note under the field lists the categories whose tickets don’t sync.`})]})]})]})]}),_jsx(Step,{title:`Choose invoice visibility`,children:_jsxs(_components.p,{children:[`With `,_jsx(_components.strong,{children:`Enable Invoice Sync`}),` on, use `,_jsx(_components.strong,{children:`Hide invoice statuses`}),` to hide closed, voided or other statuses from the Invoices page. Every invoice still syncs.`]})}),_jsx(Step,{title:`Configure Planner Auto-Import (Optional)`,children:_jsxs(_components.p,{children:[`With `,_jsx(_components.strong,{children:`Enable Opportunity Sync`}),` on, turn on `,_jsx(_components.strong,{children:`Auto-import to Planner`}),`, below the `,_jsx(_components.strong,{children:`Extended data`}),` switches, to create a planner item for each new Autotask opportunity. Use `,_jsx(_components.strong,{children:`Minimum opportunity value`}),` and `,_jsx(_components.strong,{children:`Opportunity types to auto-import`}),` to limit which ones come through. See `,_jsx(_components.a,{href:`/user-guides/planner/index#importing-psa-opportunities`,children:`Importing PSA Opportunities`}),`.`]})})]}),`\n`,_jsx(_components.p,{children:`Synchronizing source records, linking them to companies and importing portal records are separate steps. Automatic company and contact imports can create portal records when matching source records arrive, so review filters and auto-import settings before you turn them on. Check errors and the actual sync result before you treat an empty list as the final dataset.`}),`\n`,_jsx(Frame,{caption:`Branch preview: MSP staff in the Demo tenant.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-desktop.png?fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=5841ecad21a1afa0419c6acb3e08405d`,alt:`Autotask Choose data with Sync Companies, Sync Users and Enable Ticket Sync in one Core data row, company filters, company and contact auto-import and ticket sync scope pickers side by side, and the Extended data switches in a three-column grid, each with an (i) beside its name.`,width:`1440`,height:`1160`,\"data-og-width\":`1440`,\"data-og-height\":`1160`,\"data-path\":`images/product/autotask-choose-data-desktop.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-desktop.png?w=280\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=1037ece9c2a2f5b14157852942a92a16 280w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-desktop.png?w=560\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=75b1c83064590185f97b76552939f94e 560w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-desktop.png?w=840\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=e8a5ea12f0e7e93d6b4362f3fd1b34f9 840w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-desktop.png?w=1100\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=85dafa02ec5ad72849174b3870322608 1100w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-desktop.png?w=1650\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=fa0e7643de79ef831c5bf8558c3d9dac 1650w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-desktop.png?w=2500\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=115f374328aa4f982d335c2661342da6 2500w`})}),`\n`,_jsx(Accordion,{title:`Phone layout`,id:`phone-layout`,children:_jsx(Frame,{caption:`Branch preview: MSP staff in the Demo tenant.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-mobile.png?fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=c99fd61d5ab47594095196d178384883`,alt:`On a phone, Autotask Choose data stacks the Core data switches and the filter pickers in one column, each with an (i) beside its name.`,width:`390`,height:`845`,\"data-og-width\":`390`,\"data-og-height\":`845`,\"data-path\":`images/product/autotask-choose-data-mobile.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-mobile.png?w=280\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=71a93a5c988350052070c6dcdd138059 280w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-mobile.png?w=560\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=7e2ede87d17b71a69f2b1a1ced6356fc 560w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-mobile.png?w=840\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=004fcb054148dc61e31da721f77a39e9 840w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-mobile.png?w=1100\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=45446adbe8416e5fa152929b2e0705c2 1100w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-mobile.png?w=1650\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=6da164c3c4e9d6406d6ea35d6624e1c2 1650w, https://mintcdn.com/msportal/6TPG1gLweOLs0TMz/images/product/autotask-choose-data-mobile.png?w=2500\u0026fit=max\u0026auto=format\u0026n=6TPG1gLweOLs0TMz\u0026q=85\u0026s=238375c9abd55377e3ed4175c14f1164 2500w`})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`import-or-match-companies`,children:`Import or match companies`}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Import or match companies`}),`. Its first view, `,_jsx(_components.strong,{children:`Import`}),`, includes unlinked records with or without suggestions; use `,_jsx(_components.strong,{children:`Suggested`}),` to review proposed matches.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`Import`}),` beside a source company to import it on its own.`]}),`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`Import companies`}),` to open the selection dialog. It loads unmatched records across pages for the current search. Use `,_jsx(_components.strong,{children:`Select current page`}),` or `,_jsx(_components.strong,{children:`Select all pages`}),`, review the names and selected count, then confirm. Existing portal companies with the same name are matched instead of duplicated.`]}),`\n`,_jsxs(_components.li,{children:[`To link a company that already exists under a different name, choose it in the row, or review and accept the suggested match. `,_jsx(_components.strong,{children:`Review N suggested matches`}),` opens `,_jsx(_components.strong,{children:`Accept suggested matches`}),`, which lists every suggestion at 70% confidence or more with those at 90% or more already selected. Lower the `,_jsx(_components.strong,{children:`Auto-select by confidence`}),` slider, as far as 70%, to select weaker suggestions too, untick any pair you want to check yourself, then select `,_jsx(_components.strong,{children:`Apply N Matches`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Accepted matches, removed matches and ignores save when applied. Opening the import dialog alone saves nothing. See `,_jsx(_components.a,{href:`/user-guides/integrations/import-companies`,children:`Import companies`}),` for selection scope and retry guidance.`]}),`\n`,_jsx(Frame,{caption:`Branch preview: MSP staff in the Demo tenant. Suggestions at 90% or more start selected.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/9NJ-Bq-jR0B5cUKw/images/product/integration-companies-bulk-dialog-branch-preview.png?fit=max\u0026auto=format\u0026n=9NJ-Bq-jR0B5cUKw\u0026q=85\u0026s=77c48afef87d7bc596d53e873edb850d`,alt:`Accept suggested matches dialog over the Autotask Import or match companies task, with the Auto-select by confidence slider at 90%+, two 100% matches selected, Select All and Clear All, a search field and Apply 2 Matches`,width:`2880`,height:`1920`,\"data-og-width\":`2880`,\"data-og-height\":`1920`,\"data-path\":`images/product/integration-companies-bulk-dialog-branch-preview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/9NJ-Bq-jR0B5cUKw/images/product/integration-companies-bulk-dialog-branch-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=9NJ-Bq-jR0B5cUKw\u0026q=85\u0026s=d61c7ee72ed8337efbf22c761aef9cea 280w, https://mintcdn.com/msportal/9NJ-Bq-jR0B5cUKw/images/product/integration-companies-bulk-dialog-branch-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=9NJ-Bq-jR0B5cUKw\u0026q=85\u0026s=f5b903fabbf3925cf2791fb9a053e9f2 560w, https://mintcdn.com/msportal/9NJ-Bq-jR0B5cUKw/images/product/integration-companies-bulk-dialog-branch-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=9NJ-Bq-jR0B5cUKw\u0026q=85\u0026s=de2c089d1c80a1c0cbdb06ca0ce7aa2f 840w, https://mintcdn.com/msportal/9NJ-Bq-jR0B5cUKw/images/product/integration-companies-bulk-dialog-branch-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=9NJ-Bq-jR0B5cUKw\u0026q=85\u0026s=459222c74ff7f0bc4100546dd06a385a 1100w, https://mintcdn.com/msportal/9NJ-Bq-jR0B5cUKw/images/product/integration-companies-bulk-dialog-branch-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=9NJ-Bq-jR0B5cUKw\u0026q=85\u0026s=496ffbad8346b0e5af60d373fb5f0913 1650w, https://mintcdn.com/msportal/9NJ-Bq-jR0B5cUKw/images/product/integration-companies-bulk-dialog-branch-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=9NJ-Bq-jR0B5cUKw\u0026q=85\u0026s=b64a243614ee914d2940674140e4587e 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`import-or-match-users-optional`,children:`Import or match users (Optional)`}),`\n`,_jsx(_components.p,{children:`Import or match at least one company first. You can leave other companies for later and return to import more users.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Select contacts`,children:_jsxs(_components.p,{children:[`The workspace opens on `,_jsx(_components.strong,{children:`Import`}),`, which includes suggested contacts too. Use `,_jsx(_components.strong,{children:`Import`}),` beside a contact, or select contacts and choose `,_jsx(_components.strong,{children:`Import selected`}),`. Use the header checkbox to select the current page, click it again to select all pages matching the current filters, and click again to clear the selection. `,_jsx(_components.strong,{children:`Select all with email`}),` replaces the selection with contacts that have an email address across all pages matching the current filters. Large selections run in batches.`]})}),_jsx(Step,{title:`Review and confirm`,children:_jsx(_components.p,{children:`In the review panel, choose the intended Company role and review the ready-to-import and skipped counts. Contacts without an email address are skipped; you can add an address before confirming. Correct invalid addresses or clear them to skip those contacts, and resolve duplicate addresses.`})}),_jsx(Step,{title:`Check the result`,children:_jsx(_components.p,{children:`Read the result and verify the saved users. To link an existing account instead, choose that user or accept a reviewed suggestion. Importing contacts does not invite them to the portal.`})})]}),`\n`,_jsxs(_components.p,{children:[`Client contacts are imported here. See `,_jsx(_components.a,{href:`/user-guides/integrations/import-users`,children:`Import users`}),` for selection scope and retry guidance.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`import-devices-optional`,children:`Import devices (Optional)`}),`\n`,_jsxs(_components.p,{children:[`Import Autotask configuration items as devices in MSPortal. Make sure `,_jsx(_components.strong,{children:`Enable configuration item sync`}),` is on in `,_jsx(_components.strong,{children:`Choose data`}),`, then open `,_jsx(_components.strong,{children:`Import devices`}),` to map configuration item types to MSPortal device types and select the items to import. Confirm the intended company and device type before importing, then check the result in Devices.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`configure-tickets`,children:`Configure tickets`}),`\n`,_jsx(_components.p,{children:`Set up how Autotask tickets behave in MSPortal. Each change saves straight away. Wait for the saved state and resolve any reported save failure before you leave.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Review new ticket defaults`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`New ticket defaults`}),` sets the PSA values used for new tickets created in the portal. These are the same defaults as `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Tickets`}),`, and editing them requires the Ticket Settings permission. It includes the `,_jsx(_components.strong,{children:`Requester field`}),`, which records each submitter’s name in a ticket UDF. See `,_jsx(_components.a,{href:`/user-guides/settings/tickets#requester-field`,children:`Requester field`}),`.`]})}),_jsx(Step,{title:`Choose ticket statuses`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Ticket statuses`}),`, select the `,_jsx(_components.strong,{children:`Closed statuses`}),` that mean a ticket is closed. Status choices appear once queues are chosen in `,_jsx(_components.strong,{children:`Choose data`}),`; missing choices can mean the first metadata sync has not finished. To set a status after a company user replies, see `,_jsx(_components.a,{href:`#set-the-status-after-a-client-comment`,children:`Set the status after a client comment`}),`.`]})}),_jsxs(Step,{title:`Place statuses in resolution stages`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Resolution stages`}),` drive the visual indicator of ticket progress. Place each Autotask status in the stage it belongs to. A status can sit in one stage only.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Stage`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`New`})}),_jsx(_components.td,{children:`Tickets that are newly created or not yet triaged`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Triaged`})}),_jsx(_components.td,{children:`Tickets that have been reviewed and prioritized`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Working`})}),_jsx(_components.td,{children:`Tickets actively being worked on`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Waiting`})}),_jsx(_components.td,{children:`Tickets waiting for customer response or approval`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Resolved`})}),_jsx(_components.td,{children:`Tickets that are completed or closed`})]})]})]})]}),_jsx(Step,{title:`Set Autotask ticket defaults`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Fallback Resource`})}),_jsx(_components.td,{children:`Assigned when creating tickets without a specific resource. Cannot be an API-only user.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default Note Type`})}),_jsx(_components.td,{children:`Default note type for ticket comments`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Account Note Action Types to Sync`})}),_jsxs(_components.td,{children:[`Only company notes with these Autotask action types are imported and shown on the company `,_jsx(_components.strong,{children:`Notes`}),` tab. Leave empty to sync none.`]})]})]})]})}),_jsx(Step,{title:`Set a reply mailbox for emailed notes (Optional)`,children:_jsxs(_components.p,{children:[`Emailing ticket notes is off until you turn it on in `,_jsx(_components.strong,{children:`Settings > Tickets > General > Email ticket notes`}),`. To let staff and company users email a ticket note on this connection, also set `,_jsx(_components.strong,{children:`Reply mailbox`}),` under `,_jsx(_components.strong,{children:`Emailing contacts from notes`}),`. Enter the mailbox Autotask reads incoming email from. MSPortal sends the note from your sending domain with this mailbox as the reply address and the ticket number in the subject, so a reply is added to the ticket. Without it, the `,_jsx(_components.strong,{children:`Email to`}),` field is not offered on this connection’s tickets.`]})}),_jsxs(Step,{title:`Sync actions`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sync tickets now`})}),_jsx(_components.td,{children:`Trigger an immediate sync of ticket data`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Clear \u0026 Resync`})}),_jsx(_components.td,{children:`Delete this integration’s synced tickets in MSPortal and perform a fresh sync (useful after major configuration changes). Tickets in Autotask are not affected.`})]})]})]}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/user-guides/integrations/clear-and-resync-integrations`,children:`Clear and Resync Integrations`}),` before you use `,_jsx(_components.strong,{children:`Clear \u0026 Resync`}),`.`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`set-the-status-after-a-client-comment`,children:`Set the status after a client comment`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Branch preview:`}),` These Autotask reply settings and screenshots describe an\nunreleased update. They are not yet verified in production.`]})}),`\n`,_jsx(_components.p,{children:`Use this setting to move an Autotask ticket to a chosen status after a company user successfully saves a public note through MSPortal. MSP staff notes, internal notes and private notes do not trigger it.`}),`\n`,_jsxs(_components.p,{children:[`You need permission to manage integrations. The Autotask API user also needs `,_jsx(_components.strong,{children:`Tickets`}),` `,_jsx(_components.strong,{children:`Edit`}),` on its security level. `,_jsx(_components.strong,{children:`Ticket creation and updates`}),` under `,_jsx(_components.strong,{children:`Permissions`}),` shows whether it has that.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Configure tickets`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Settings > Integrations > Autotask PSA`}),`, open the connection you want to change, and select `,_jsx(_components.strong,{children:`Configure tickets`}),` in its setup guide.`]})}),_jsx(Step,{title:`Choose a reply status`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Ticket statuses > Status after a client comment`}),`, select an active status from this Autotask connection. Choose `,_jsx(_components.strong,{children:`None`}),` to turn the automatic status update off.`]})}),_jsxs(Step,{title:`Choose what happens on closed tickets`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Replies on closed tickets`}),` becomes available after you select a reply status.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Choice`}),_jsx(_components.th,{children:`Result after a company user’s public note`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Keep closed or resolved`}),` (default)`]}),_jsx(_components.td,{children:`Save the note and leave a closed or resolved ticket’s status unchanged.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Change to reply status`})}),_jsx(_components.td,{children:`Apply the selected reply status even when the ticket is closed or resolved. Choose an open reply status if you want replies to reopen tickets.`})]})]})]}),_jsxs(_components.p,{children:[`Closed-ticket handling includes statuses marked closed in Autotask, your `,_jsx(_components.strong,{children:`Closed statuses`}),`, and statuses placed in the `,_jsx(_components.strong,{children:`Resolved`}),` resolution stage.`]})]}),_jsx(Step,{title:`Wait for each change to save`,children:_jsxs(_components.p,{children:[`Each selection saves immediately. Resolve any save error before leaving, then reload to confirm the saved choices. To stop automatic status changes later, select `,_jsx(_components.strong,{children:`None`}),`.`]})})]}),`\n`,_jsx(_components.p,{children:`The setting applies to this integration’s tickets. Company overrides are not supported in this release. MSPortal writes only the reply status for this step; it does not write the assigned technician, queue or priority. Autotask workflows may react separately to the status change.`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Desktop`,id:`desktop`,children:_jsx(Frame,{caption:`Branch preview in MSPortal Demo: In Progress is an example reply status; closed or resolved tickets stay closed by default.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-desktop-preview.png?fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=564e733daf8b87be5ae3d3bb7f2b107c`,alt:`Autotask Ticket statuses with In Progress selected after a client comment and Keep closed or resolved selected`,width:`1968`,height:`495`,\"data-og-width\":`1968`,\"data-og-height\":`495`,\"data-path\":`images/product/autotask-reply-status-desktop-preview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-desktop-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=27f069e02c9c007ef3628ce9e491dd18 280w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-desktop-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=886afac58ef195786a1154d81209a000 560w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-desktop-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=7b7a4d3e15b3fb01ae8e7c85bda3e7fa 840w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-desktop-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=5af25d331fc6ca7d0d1f1c4dc8eb781c 1100w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-desktop-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=389939858ee22158b99acd6fc7534315 1650w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-desktop-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=59172d98e1e550006fff765bef1a1325 2500w`})})}),_jsx(Tab,{title:`Phone`,id:`phone`,children:_jsx(Frame,{caption:`Branch preview in MSPortal Demo: the same reply settings on a phone.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-mobile-preview.png?fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=0c653a52fc305dc79519d259ffb47f51`,alt:`Phone view of Autotask reply status set to In Progress and closed-ticket handling set to Keep closed or resolved`,width:`687`,height:`474`,style:{width:`100%`,maxWidth:`390px`,height:`auto`},\"data-og-width\":`687`,\"data-og-height\":`474`,\"data-path\":`images/product/autotask-reply-status-mobile-preview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-mobile-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=66057ee7befb0377ca3a0b7cd4d07141 280w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-mobile-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=16d8960fba6a03968ce24a0efe7c62fb 560w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-mobile-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=bccf8dd76484d8efa02ea4d473f99695 840w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-mobile-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=9c1df6d0b2d1964ccb8e56b7a69bb8e3 1100w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-mobile-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=a9c381a61cc90497c54e98e3529b9c94 1650w, https://mintcdn.com/msportal/i4gL5UzsAFSGAnOB/images/product/autotask-reply-status-mobile-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i4gL5UzsAFSGAnOB\u0026q=85\u0026s=7f318d152bf1a5d3f281b26b8a3905e8 2500w`})})})]}),`\n`,_jsxs(_components.p,{children:[`If the note saves but the status update fails, the portal and browser extension tell the company user that the note was saved and offer `,_jsx(_components.strong,{children:`Retry status update`}),` when a retry is available. Retrying changes only the status and never posts another note. See `,_jsx(_components.a,{href:`/user-guides/ticketing/follow-up-on-a-ticket#when-a-reply-changes-the-ticket-status`,children:`When a reply changes the ticket status`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Problem`}),_jsx(_components.th,{children:`What to check`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No reply statuses are available`}),_jsx(_components.td,{children:`Check this connection’s selected queues and metadata sync, then reload. The target must be an active status from this integration.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A staff note did not change the status`}),_jsx(_components.td,{children:`Only company users’ public notes trigger this setting.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A closed ticket stayed closed`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Keep closed or resolved`}),` is the default. Select `,_jsx(_components.strong,{children:`Change to reply status`}),` only if replies should apply the chosen status to closed tickets too.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A note saved but its status did not update`}),_jsx(_components.td,{children:`Check the Autotask connection, API user’s write access and whether the selected reply status is still active. Retry the status when offered; do not post the note again.`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`configure-opportunities-optional`,children:`Configure opportunities (Optional)`}),`\n`,_jsxs(_components.p,{children:[`Set default values for opportunities created from MSPortal. These settings only apply when `,_jsx(_components.strong,{children:`Enable Opportunity Sync`}),` is on in `,_jsx(_components.strong,{children:`Choose data`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Fallback Owner`})}),_jsx(_components.td,{children:`The owner assigned to opportunities when the user doesn’t have an Autotask account. Cannot be an API-only user.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default Category`})}),_jsx(_components.td,{children:`Default category for new opportunities (optional)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default Stage`})}),_jsx(_components.td,{children:`The starting stage for new opportunities (required by Autotask)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default Status`})}),_jsx(_components.td,{children:`The starting status for new opportunities (required by Autotask)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Projected Close Date (Days from Start)`})}),_jsx(_components.td,{children:`Number of days from start date for projected close`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`This task also controls how synced opportunities reach the Planner. Automatic Planner imports and their filters stay in `,_jsx(_components.strong,{children:`Choose data`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`review`,children:`Review`}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Review`}),`, resolve any required incomplete tasks, then select `,_jsx(_components.strong,{children:`Finish setup`}),`. Each task saves its own changes, so finishing setup does not apply a separate batch of pending company or user imports. Syncs and imports keep running in the background; check their results separately.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`managing-your-integration`,children:`Managing Your Integration`}),`\n`,_jsxs(_components.p,{children:[`After setup, open the Autotask PSA connection from `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Integrations`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Overview`}),` and `,_jsx(_components.strong,{children:`Sync activity`}),`: Check connection status, sync results and errors`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Setup guide`}),` tasks: Change saved scope, matches and settings`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Run sync`}),`: Request a manual sync of all data, or one data type`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`More actions`}),` > `,_jsx(_components.strong,{children:`Rename`}),`: Label the connection`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`More actions`}),` > `,_jsx(_components.strong,{children:`Disconnect…`}),`: Remove the stored credentials, company matches and synced data after confirmation. This cannot be undone. Revoke the API user’s credentials in Autotask separately.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`To replace the API credentials, open `,_jsx(_components.strong,{children:`Connect`}),`, enter the new username or secret, select `,_jsx(_components.strong,{children:`Test connection`}),`, then select `,_jsx(_components.strong,{children:`Save changes`}),`. Leave masked values unchanged to keep them. A test alone does not save replacement credentials, so confirm the saved connection before you revoke the old credential in Autotask.`]}),`\n`,_jsx(Heading,{level:`3`,id:`webhook-management`,children:`Webhook Management`}),`\n`,_jsx(_components.p,{children:`MSPortal provisions the Autotask webhooks for ticket changes, so no manual webhook setup is required in Autotask. A weekly check re-creates any webhook that has gone missing. If webhooks stop working, verify that your API user’s security role still allows creating webhooks, then contact MSPortal support.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`write-warranty-dates-back-to-autotask`,children:`Write warranty dates back to Autotask`}),`\n`,_jsx(_components.p,{children:`Warranty writeback is an optional write to Autotask. Turn it on only when you want MSPortal’s warranty dates to update Autotask configuration items.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Turn on Warranty writeback`,children:_jsxs(_components.p,{children:[`Open the Autotask PSA connection, select `,_jsx(_components.strong,{children:`Choose data`}),` and turn on `,_jsx(_components.strong,{children:`Warranty writeback`}),`. It does not need `,_jsx(_components.strong,{children:`Enable configuration item sync`}),`. Devices are matched by RMM device UID, then by serial number in the mapped company.`]})}),_jsx(Step,{title:`Wait for the save`,children:_jsx(_components.p,{children:`The switch saves as soon as you change it. Wait for the saved state before you leave.`})})]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/user-guides/integrations/autotask-warranty-writeback`,children:`Warranty writeback to Autotask`}),` for the permissions, matching rules and troubleshooting.`]}),`\n`,_jsx(Heading,{level:`2`,id:`import-autotask-native-csat-for-dashboards-and-reports`,children:`Import Autotask native CSAT for dashboards and reports`}),`\n`,_jsx(_components.p,{children:`This imports survey results already collected by Autotask’s built-in surveys. You do not need Simplesat or a new MSPortal survey. The import is off by default.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Grant survey rating rights`,children:_jsxs(_components.p,{children:[`In Autotask, open `,_jsx(_components.strong,{children:`Admin`}),` > `,_jsx(_components.strong,{children:`Resources/Users`}),` > `,_jsx(_components.strong,{children:`Security Levels`}),` and edit the level assigned to the API user. Under `,_jsx(_components.strong,{children:`Other`}),` > `,_jsx(_components.strong,{children:`Surveys`}),`, enable `,_jsx(_components.strong,{children:`Can view Account Survey Ratings and Contact Survey Ratings`}),` and `,_jsx(_components.strong,{children:`Can view Resource Survey Ratings`}),`.`]})}),_jsx(Step,{title:`Re-check permissions`,children:_jsxs(_components.p,{children:[`In MSPortal, open the Autotask PSA connection, select `,_jsx(_components.strong,{children:`Permissions`}),`, click `,_jsx(_components.strong,{children:`Re-check`}),` and confirm `,_jsx(_components.strong,{children:`Satisfaction feedback`}),` is granted.`]})}),_jsx(Step,{title:`Turn on the import`,children:_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Choose data`}),` and turn on `,_jsx(_components.strong,{children:`Import satisfaction ratings`}),`. There is no rating scale to choose, because Autotask survey questions rate `,_jsx(_components.strong,{children:`1 to 5`}),`. Each completed survey’s overall rating is rounded to a whole number on that scale.`]})}),_jsx(Step,{title:`Start the first import`,children:_jsx(_components.p,{children:`Wait for the switch to save, then start the sync when it is offered. Later imports run hourly. A saved setting does not mean every response has arrived.`})}),_jsx(Step,{title:`Check company links`,children:_jsx(_components.p,{children:`Make sure the surveyed companies are linked to portal companies and their tickets have synced. A result whose company is not linked will not appear in company-scoped CSAT results until a later sync can resolve it. Technician attribution uses the assigned resource on the synced ticket.`})}),_jsx(Step,{title:`Grant read access`,children:_jsxs(_components.p,{children:[`Give intended readers `,_jsx(_components.strong,{children:`Surveys`}),` > `,_jsx(_components.strong,{children:`Read`}),` > `,_jsx(_components.strong,{children:`CSAT`}),` in their role. Building dashboards and reports also needs the matching permissions.`]})})]}),`\n`,_jsx(_components.p,{children:`Only completed surveys are imported. Surveys that were sent but not answered, and surveys completed without answering any rated question, are not counted. Autotask does not provide free-text survey answers to integrations, so imported responses carry ratings only.`}),`\n`,_jsx(Heading,{level:`3`,id:`present-the-imported-results`,children:`Present the imported results`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Where`}),_jsx(_components.th,{children:`How`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`CSAT Dashboard`})}),_jsxs(_components.td,{children:[`Open `,_jsx(_components.strong,{children:`Surveys`}),` > `,_jsx(_components.strong,{children:`CSAT Dashboard`}),` to read scores and trends, or export responses. Autotask results are grouped under `,_jsx(_components.strong,{children:`Autotask PSA satisfaction`}),`. See `,_jsx(_components.a,{href:`/user-guides/surveys/read-csat-feedback`,children:`Read and export support satisfaction feedback`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Custom dashboards`})}),_jsxs(_components.td,{children:[`Add `,_jsx(_components.strong,{children:`CSAT Overview`}),`, `,_jsx(_components.strong,{children:`CSAT Trend`}),`, `,_jsx(_components.strong,{children:`CSAT by Company`}),` or `,_jsx(_components.strong,{children:`Recent CSAT Feedback`}),` from the widget library, then save the dashboard. See `,_jsx(_components.a,{href:`/user-guides/dashboards/create-and-edit-dashboard`,children:`Create and edit a dashboard`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Reports`})}),_jsxs(_components.td,{children:[`Use the same CSAT blocks in the report builder, select the company and reporting period, and save. See `,_jsx(_components.a,{href:`/user-guides/reporting/index#native-psa-csat-in-reports`,children:`Reporting`}),`.`]})]})]})]}),`\n`,_jsx(_components.p,{children:`These CSAT views can include other connected feedback sources alongside Autotask. Check the company selection, dates and survey filter before you read a total as Autotask-only.`}),`\n`,_jsx(Heading,{level:`3`,id:`if-autotask-csat-is-missing`,children:`If Autotask CSAT is missing`}),`\n`,_jsxs(_components.p,{children:[`Connecting Autotask does not turn on the import by itself. Check that `,_jsx(_components.strong,{children:`Import satisfaction ratings`}),` is saved, `,_jsx(_components.strong,{children:`Satisfaction feedback`}),` is granted, the companies are linked, the tickets have synced and the reader has the CSAT permission. If the `,_jsx(_components.strong,{children:`Import satisfaction ratings`}),` switch does not appear at all, contact MSPortal support.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`additional-configuration`,children:`Additional Configuration`}),`\n`,_jsx(_components.p,{children:`After completing setup, you may want to configure additional settings:`}),`\n`,_jsx(Heading,{level:`3`,id:`configure-ticket-settings`,children:`Configure Ticket Settings`}),`\n`,_jsxs(_components.p,{children:[`Navigate to `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Tickets`}),` to:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Set the `,_jsx(_components.strong,{children:`Delivery Method`}),` to `,_jsx(_components.strong,{children:`PSA`})]}),`\n`,_jsxs(_components.li,{children:[`Ensure `,_jsx(_components.strong,{children:`Autotask`}),` is selected as your PSA provider`]}),`\n`,_jsx(_components.li,{children:`Configure ticket categories and map them to Autotask ticket types`}),`\n`,_jsxs(_components.li,{children:[`Set `,_jsx(_components.strong,{children:`Ticket Defaults`}),` for tickets created from compliance tasks or automation`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Ticket defaults are also used as the starting point for new ticket templates, making template creation faster.`})}),`\n`,_jsx(Heading,{level:`3`,id:`configure-display-groups`,children:`Configure Display Groups`}),`\n`,_jsx(_components.p,{children:`Display groups control which ticket fields users can see based on their role.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Navigate to `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Tickets`})]}),`\n`,_jsxs(_components.li,{children:[`Scroll to `,_jsx(_components.strong,{children:`Display Groups`}),` and click `,_jsx(_components.strong,{children:`Create Group`})]}),`\n`,_jsxs(_components.li,{children:[`Configure:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Name for the display group`}),`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`Autotask`}),` as the PSA provider`]}),`\n`,_jsx(_components.li,{children:`Assign roles that should use this display group`}),`\n`,_jsx(_components.li,{children:`Select which fields are visible`}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Only grant access to information users need for their role. Follow the principle of least privilege.`})}),`\n`,_jsx(Heading,{level:`3`,id:`configure-allowed-statuses`,children:`Configure Allowed Statuses`}),`\n`,_jsx(_components.p,{children:`Set which ticket statuses users can select when updating tickets:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Navigate to `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Tickets`})]}),`\n`,_jsx(_components.li,{children:`Configure status permissions for each display group`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`We recommend preventing users from closing tickets directly. Instead, use a “Ready for Review” status to ensure tickets are reviewed before closure.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`devices-from-autotask-configuration-items`,children:`Devices from Autotask configuration items`}),`\n`,_jsxs(_components.p,{children:[`MSPortal treats an RMM, MDM or network tool as the source of truth for a device. When an RMM is connected, a Autotask configuration item keeps or creates a device only when its type has `,_jsx(_components.strong,{children:`Auto-import`}),` on and is not ignored in `,_jsx(_components.a,{href:`/user-guides/integrations/import-devices`,children:`Import Devices`}),`. Configuration items of other types add their details to devices your RMM reports.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Configuration items removed in Autotask.`}),` Once a day MSPortal checks the full list of active configuration items in Autotask. A configuration item that is deleted or made inactive is removed from staging three days after Autotask stops listing it, and stays if it comes back in the meantime.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`What happens to the device.`}),` When the configuration item leaves staging, its device moves to another integration that still reports it, such as your RMM. A device nothing else reports is removed. In a tenant with an RMM, an IT Glue or other PSA record keeps the device only when its type has Auto-import on.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Only companies still mapped to this connection are affected. Unmapping a company or excluding a type stops syncing those records and keeps their devices. Archived devices are never removed.`}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Issue`}),_jsx(_components.th,{children:`Solution`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Connection test fails`}),_jsx(_components.td,{children:`Verify your API username and secret are correct. Ensure the API user has the MSPortal security role. Read the reported error text.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A data option is unavailable`}),_jsxs(_components.td,{children:[`Check its result in `,_jsx(_components.strong,{children:`Permissions`}),`, grant the named permission and select `,_jsx(_components.strong,{children:`Re-check`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Tickets not syncing`}),_jsxs(_components.td,{children:[`Check that the correct queues and categories are selected in `,_jsx(_components.strong,{children:`Choose data`}),` and that ticket statuses aren’t excluded. The note under `,_jsx(_components.strong,{children:`Categories`}),` lists categories that don’t sync, including ones added in Autotask after setup. See `,_jsx(_components.a,{href:`/user-guides/integrations/faq#fix-missing-tickets`,children:`Fix missing tickets`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Companies or tickets are missing`}),_jsxs(_components.td,{children:[`Check saved filters in `,_jsx(_components.strong,{children:`Choose data`}),`, the result in `,_jsx(_components.strong,{children:`Sync activity`}),` and company links.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`New statuses are absent`}),_jsx(_components.td,{children:`Wait for metadata to sync, check the selected queues and reload the task.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Webhooks not working`}),_jsx(_components.td,{children:`Ensure your API user’s security role can create webhooks, then contact MSPortal support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Missing data`}),_jsxs(_components.td,{children:[`Open `,_jsx(_components.strong,{children:`Permissions`}),`, select `,_jsx(_components.strong,{children:`Re-check`}),` and grant the setting named beside anything not permitted. The rows are listed under `,_jsx(_components.a,{href:`#create-security-role`,children:`Create Security Role`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`New tickets arrive by email saying the PSA was unavailable`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Ticket creation and updates`}),` is not permitted. Under `,_jsx(_components.strong,{children:`Service Desk`}),`, set `,_jsx(_components.strong,{children:`Tickets`}),` Add and Edit to `,_jsx(_components.strong,{children:`Yes`}),` on the API user’s security level.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Contacts not importing`}),_jsxs(_components.td,{children:[`Verify `,_jsx(_components.strong,{children:`Contact Auto-Import`}),` is on and a default role is selected in `,_jsx(_components.strong,{children:`Choose data`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Setup finished but records are absent`}),_jsxs(_components.td,{children:[`Check background errors in `,_jsx(_components.strong,{children:`Sync activity`}),`, imports you have not run yet and the selected company.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Projects load, but a status or task edit fails`}),_jsxs(_components.td,{children:[`Check `,_jsx(_components.strong,{children:`Client \u0026 Internal`}),` View is set to All, then task restrictions and Line of Business scope.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Creating a project or applying a template fails`}),_jsxs(_components.td,{children:[`Check `,_jsx(_components.strong,{children:`Client \u0026 Internal`}),` Add is set to Yes, and the resource and work type choices. Check partial results before retrying.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Logging project time fails`}),_jsxs(_components.td,{children:[`Check `,_jsx(_components.strong,{children:`TimeEntries`}),` create access, `,_jsx(_components.strong,{children:`Can enter time on`}),`, the resource mapping, billing field permissions and Autotask’s completed task and timesheet rules.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Survey results are missing from CSAT views`}),_jsxs(_components.td,{children:[`Check the saved `,_jsx(_components.strong,{children:`Import satisfaction ratings`}),` switch, the security level’s survey rating rights, company links, synced tickets and the reader’s CSAT permission.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`frequently-asked-questions`,children:`Frequently asked questions`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Does Test connection only test credentials?`,id:`does-test-connection-only-test-credentials`,children:_jsxs(_components.p,{children:[`Yes. Select `,_jsx(_components.strong,{children:`Save and continue`}),` after a successful test to create a connection, or `,_jsx(_components.strong,{children:`Save changes`}),` to save replacement credentials on an existing connection.`]})}),_jsx(Accordion,{title:`Does a green permissions result verify ticket writes?`,id:`does-a-green-permissions-result-verify-ticket-writes`,children:_jsxs(_components.p,{children:[`Yes, for tickets. `,_jsx(_components.strong,{children:`Ticket creation and updates`}),` reads whether the API user may add and edit tickets, without creating one. Other writes, such as projects, time entries and warranty dates, are not checked: confirm those with a real action.`]})}),_jsx(Accordion,{title:`Does MSPortal write back to Autotask, or is it one way?`,id:`does-msportal-write-back-to-autotask-or-is-it-one-way`,children:_jsxs(_components.p,{children:[`It writes back. Project status, task status, task owners, and project, phase and task dates you change in MSPortal are written to Autotask, so you do not update them again there. Phase renames, milestones and onboarding portal dates stay in MSPortal. See `,_jsx(_components.a,{href:`#what-msportal-writes-back-to-autotask-projects`,children:`What MSPortal writes back to Autotask projects`}),`.`]})}),_jsx(Accordion,{title:`Does Finish setup mean all data is ready?`,id:`does-finish-setup-mean-all-data-is-ready`,children:_jsx(_components.p,{children:`No. Check the background sync result and verify company, user and device imports separately.`})}),_jsx(Accordion,{title:`Will every discovered contact receive portal access?`,id:`will-every-discovered-contact-receive-portal-access`,children:_jsx(_components.p,{children:`Discovery and import are separate. Review user matches, company links and the permissions assigned to portal users; invitation is a separate workflow.`})}),_jsx(Accordion,{title:`Can I dashboard or report on Autotask native survey results?`,id:`can-i-dashboard-or-report-on-autotask-native-survey-results`,children:_jsxs(_components.p,{children:[`Yes. Turn on `,_jsx(_components.strong,{children:`Import satisfaction ratings`}),` in the Autotask connection’s `,_jsx(_components.strong,{children:`Choose data`}),` task and grant the API user’s security level the survey rating rights. Completed survey results are available in the CSAT Dashboard, custom dashboard CSAT widgets, report blocks and CSV exports, subject to company mapping and role access. You can keep using Autotask’s own surveys; Simplesat is not required.`]})}),_jsx(Accordion,{title:`Can I replace saved credentials by retesting the form?`,id:`can-i-replace-saved-credentials-by-retesting-the-form`,children:_jsxs(_components.p,{children:[`A retest only verifies access. Select `,_jsx(_components.strong,{children:`Save changes`}),` after testing the replacement credentials, then confirm the saved connection before revoking the old credential.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-guides`,children:`Related guides`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/integrations/index`,children:`Connect and manage integrations`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/integrations/import-companies`,children:`Import companies`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/integrations/import-users`,children:`Import users`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/settings/integration-company-mapping`,children:`Company mapping`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/settings/tickets`,children:`Ticket settings`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/user-guides/integrations/autotask-warranty-writeback`,children:`Warranty writeback to Autotask`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Configure Autotask PSA Integration","description":"Connect Autotask PSA, import native survey results for CSAT dashboards and reports, and choose data scope","icon":"plug","href":"/user-guides/integrations/enable-autotask-integration"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Part 1: Configure Autotask PSA","slug":"part-1-configure-autotask-psa","depth":2,"children":[{"title":"Create Security Role","slug":"create-security-role","depth":3,"children":[]},{"title":"Create API User","slug":"create-api-user","depth":3,"children":[]}]},{"title":"Project management permissions","slug":"project-management-permissions","depth":2,"children":[{"title":"What MSPortal writes back to Autotask projects","slug":"what-msportal-writes-back-to-autotask-projects","depth":3,"children":[]}]},{"title":"Part 2: Connect Autotask in MSPortal","slug":"part-2-connect-autotask-in-msportal","depth":2,"children":[{"title":"Open the connection","slug":"open-the-connection","depth":3,"children":[]},{"title":"Connect","slug":"connect","depth":3,"children":[]},{"title":"Permissions","slug":"permissions","depth":3,"children":[]},{"title":"Choose data","slug":"choose-data","depth":3,"children":[]},{"title":"Import or match companies","slug":"import-or-match-companies","depth":3,"children":[]},{"title":"Import or match users (Optional)","slug":"import-or-match-users-optional","depth":3,"children":[]},{"title":"Import devices (Optional)","slug":"import-devices-optional","depth":3,"children":[]},{"title":"Configure tickets","slug":"configure-tickets","depth":3,"children":[]},{"title":"Set the status after a client comment","slug":"set-the-status-after-a-client-comment","depth":3,"children":[]},{"title":"Configure opportunities (Optional)","slug":"configure-opportunities-optional","depth":3,"children":[]},{"title":"Review","slug":"review","depth":3,"children":[]}]},{"title":"Managing Your Integration","slug":"managing-your-integration","depth":2,"children":[{"title":"Webhook Management","slug":"webhook-management","depth":3,"children":[]}]},{"title":"Write warranty dates back to Autotask","slug":"write-warranty-dates-back-to-autotask","depth":2,"children":[]},{"title":"Import Autotask native CSAT for dashboards and reports","slug":"import-autotask-native-csat-for-dashboards-and-reports","depth":2,"children":[{"title":"Present the imported results","slug":"present-the-imported-results","depth":3,"children":[]},{"title":"If Autotask CSAT is missing","slug":"if-autotask-csat-is-missing","depth":3,"children":[]}]},{"title":"Additional Configuration","slug":"additional-configuration","depth":2,"children":[{"title":"Configure Ticket Settings","slug":"configure-ticket-settings","depth":3,"children":[]},{"title":"Configure Display Groups","slug":"configure-display-groups","depth":3,"children":[]},{"title":"Configure Allowed Statuses","slug":"configure-allowed-statuses","depth":3,"children":[]}]},{"title":"Devices from Autotask configuration items","slug":"devices-from-autotask-configuration-items","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Frequently asked questions","slug":"frequently-asked-questions","depth":2,"children":[]},{"title":"Related guides","slug":"related-guides","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/msportal/d65dc731b8cde0aa/roadmap-embed.js"],"subdomain":"msportal","siteName":"MSPortal.ai Documentation","title":"Configure Autotask PSA Integration - MSPortal.ai Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T18:33:36.651Z","originalFileLocation":"user-guides/integrations/enable-autotask-integration.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect Autotask PSA, import native survey results for CSAT dashboards and reports, and choose data scope\">\u003cmeta data-mint-head name=\"application-name\" content=\"MSPortal.ai Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Configure Autotask PSA Integration - MSPortal.ai Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect Autotask PSA, import native survey results for CSAT dashboards and reports, and choose data scope\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MSPortal.ai Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://msportal.mintlify.site/_mintlify/api/og/v2?division=PSA+and+ticketing\u0026amp;title=Configure+Autotask+PSA+Integration\u0026amp;description=Connect+Autotask+PSA%2C+import+native+survey+results+for+CSAT+dashboards+and+reports%2C+and+choose+data+scope\u0026amp;theme=88706d4dcbb07b7aeafbf701\u0026amp;signature=946d67385ced8f79662c3120c225fe0840a613aa42fe20f146c7d870d208493a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Configure Autotask PSA Integration - MSPortal.ai Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect Autotask PSA, import native survey results for CSAT dashboards and reports, and choose data scope\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://msportal.mintlify.site/_mintlify/api/og/v2?division=PSA+and+ticketing\u0026amp;title=Configure+Autotask+PSA+Integration\u0026amp;description=Connect+Autotask+PSA%2C+import+native+survey+results+for+CSAT+dashboards+and+reports%2C+and+choose+data+scope\u0026amp;theme=88706d4dcbb07b7aeafbf701\u0026amp;signature=946d67385ced8f79662c3120c225fe0840a613aa42fe20f146c7d870d208493a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/msportal/MdEo74vho503Sp8Y/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MSPortal.ai Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0C8376\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/user-guides/integrations/enable-autotask-integration.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.msportal.ai/#organization\",\"name\":\"MSPortal.ai Documentation\",\"url\":\"https://docs.msportal.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/msportal/KnbwIXtZSTlVJTt6/logo/light.svg?fit=max\u0026auto=format\u0026n=KnbwIXtZSTlVJTt6\u0026q=85\u0026s=eb69f6d6bf16b2c401770aef19ade1d2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.msportal.ai#website\",\"name\":\"MSPortal.ai Documentation\",\"url\":\"https://docs.msportal.ai\",\"publisher\":{\"@id\":\"https://docs.msportal.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration#webpage\",\"url\":\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration\",\"name\":\"Configure Autotask PSA Integration\",\"description\":\"Connect Autotask PSA, import native survey results for CSAT dashboards and reports, and choose data scope\",\"dateModified\":\"2026-11-16T18:33:36.651Z\",\"isPartOf\":{\"@id\":\"https://docs.msportal.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"PSA and ticketing\",\"item\":\"https://docs.msportal.ai/user-guides/integrations/enable-connectwise-integration\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Configure Autotask PSA Integration\",\"item\":\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration#article\",\"headline\":\"Configure Autotask PSA Integration\",\"name\":\"Configure Autotask PSA Integration\",\"description\":\"Connect Autotask PSA, import native survey results for CSAT dashboards and reports, and choose data scope\",\"url\":\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration\",\"mainEntityOfPage\":{\"@id\":\"https://docs.msportal.ai/user-guides/integrations/enable-autotask-integration#webpage\"},\"dateModified\":\"2026-11-16T18:33:36.651Z\",\"publisher\":{\"@id\":\"https://docs.msportal.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.msportal.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MSPortal.ai Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"MSPortal.ai Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/user-guides/integrations/enable-autotask-integration.md","siteName":"MSPortal.ai Documentation","nav":{"global":null,"tabs":[{"tab":"Company Guides","pages":[{"title":"Company Guides","href":"/user-guides/account/manage-your-profile"}]},{"tab":"MSP Guides","anchors":[{"anchor":"Getting started","icon":"rocket","pages":[{"title":"Getting started","href":"/user-guides/getting-started"}]},{"anchor":"Planning","icon":"compass","pages":[{"title":"Planning","href":"/user-guides/company-overview"}]},{"anchor":"Operations","icon":"briefcase","pages":[{"title":"Operations","href":"/user-guides/client-onboarding"}]},{"anchor":"Protection","icon":"shield-halved","pages":[{"title":"Protection","href":"/user-guides/cloud"}]},{"anchor":"MSP Tools","icon":"toolbox","pages":[{"title":"MSP Tools","href":"/user-guides/msp-tools"}]},{"anchor":"Administration","icon":"gear","pages":[{"title":"Administration","href":"/user-guides/settings"}]},{"anchor":"Integrations","icon":"plug","groups":[{"group":"Overview, imports and sync","pages":[{"title":"Integration setup guides","icon":"plug","href":"/user-guides/integrations"},{"title":"Integration troubleshooting","icon":"plug","href":"/user-guides/integrations/faq"},{"title":"Sync Schedules","href":"/user-guides/integrations/sync-schedules"},{"title":"Import Users","icon":"plug","href":"/user-guides/integrations/import-users"},{"title":"Import Companies","icon":"plug","href":"/user-guides/integrations/import-companies"},{"title":"Import Devices","icon":"server","href":"/user-guides/integrations/import-devices"},{"title":"Clear and Resync Integrations","icon":"plug","href":"/user-guides/integrations/clear-and-resync-integrations"},{"title":"Warranty Writeback to Hudu and IT Glue Flexible Assets","icon":"shield-halved","href":"/user-guides/integrations/documentation-warranty-writeback"},{"title":"Warranty Writeback to Autotask","icon":"arrows-rotate","href":"/user-guides/integrations/autotask-warranty-writeback"},{"title":"Warranty Writeback to IT Glue Configurations","icon":"arrows-rotate","href":"/user-guides/integrations/itglue-configuration-warranty-writeback"}]},{"group":"PSA and ticketing","pages":[{"title":"Configure ConnectWise Manage Integration","icon":"plug","href":"/user-guides/integrations/enable-connectwise-integration"},{"title":"Configure ConnectWise Asio Integration","icon":"plug","href":"/user-guides/integrations/enable-connectwise-asio-integration"},{"title":"Resync ConnectWise PSA Settings","description":"Refresh ConnectWise boards, statuses, priorities and types in MSPortal after you change them in ConnectWise","icon":"arrows-rotate","href":"/user-guides/integrations/connectwise-resync-psa-settings"},{"title":"Configure Autotask PSA Integration","icon":"plug","href":"/user-guides/integrations/enable-autotask-integration"},{"title":"Configure Halo PSA Integration","description":"Connect Halo PSA, import native CSAT satisfaction ratings for dashboards and reports, and choose company and user scope","icon":"plug","href":"/user-guides/integrations/enable-halo-integration"},{"title":"Create Custom Halo PSA Role and API User","icon":"user-shield","href":"/user-guides/integrations/halo-psa-custom-role-and-user"},{"title":"Configure Syncro Integration","icon":"plug","href":"/user-guides/integrations/enable-syncro-integration"},{"title":"Configure NinjaOne Integration","icon":"plug","href":"/user-guides/integrations/enable-ninjaone-integration"},{"title":"Configure NinjaOne Ticketing Integration","icon":"ticket","href":"/user-guides/integrations/enable-ninjaone-ticketing-integration"}]},{"group":"RMM and networks","pages":[{"title":"Configure Addigy Integration","icon":"apple","href":"/user-guides/integrations/enable-addigy-integration"},{"title":"Configure Datto RMM Integration","icon":"plug","href":"/user-guides/integrations/enable-datto-rmm-integration"},{"title":"Configure N-able N-central Integration","icon":"server","href":"/user-guides/integrations/enable-ncentral-integration"},{"title":"Configure Action1 Integration","icon":"plug","href":"/user-guides/integrations/enable-action1-integration"},{"title":"Configure Cisco Meraki Integration","icon":"network-wired","href":"/user-guides/integrations/enable-meraki-integration"},{"title":"Configure UniFi Console Integration","icon":"wifi","href":"/user-guides/integrations/enable-unifi-integration"},{"title":"Connect Domotz and Review Network Health","icon":"network-wired","href":"/user-guides/integrations/enable-domotz-integration"},{"title":"Configure Fortinet Integration","icon":"plug","href":"/user-guides/integrations/enable-fortinet-integration"},{"title":"Neo Agent Compatibility","icon":"robot","href":"/user-guides/integrations/neo-agent"},{"title":"Connect Auvik and review network data","icon":"plug","href":"/user-guides/integrations/enable-auvik-integration"},{"title":"Connect Auvik SaaS Management","icon":"cloud","href":"/user-guides/integrations/enable-auvik-saas-management-integration"},{"title":"Provide LogicMonitor API access","icon":"plug","href":"/user-guides/integrations/enable-logicmonitor-integration"},{"title":"Connect WatchGuard Cloud","icon":"plug","href":"/user-guides/integrations/enable-watchguard-integration"}]},{"group":"Security and training","pages":[{"title":"Configure Cork Integration","icon":"shield-halved","href":"/user-guides/integrations/enable-cork-integration"},{"title":"Configure Huntress Integration","icon":"shield-dog","href":"/user-guides/integrations/enable-huntress-integration"},{"title":"Configure Wirespeed Integration","icon":"shield-halved","href":"/user-guides/integrations/enable-wirespeed-integration"},{"title":"Configure Petra Security Integration","icon":"plug","href":"/user-guides/integrations/enable-petra-integration"},{"title":"Configure Bitdefender GravityZone Integration","icon":"plug","href":"/user-guides/integrations/enable-bitdefender-integration"},{"title":"Configure RoboShadow Integration","icon":"plug","href":"/user-guides/integrations/enable-roboshadow-integration"},{"title":"Configure Cyrisma Integration","icon":"plug","href":"/user-guides/integrations/enable-cyrisma-integration"},{"title":"Configure ScoutDNS Integration","icon":"plug","href":"/user-guides/integrations/enable-scoutdns-integration"},{"title":"Configure Breach Secure Now Integration","icon":"shield-halved","href":"/user-guides/integrations/enable-breach-secure-now-integration"},{"title":"Configure Phin Security Integration","icon":"shield-halved","href":"/user-guides/integrations/enable-phin-integration"},{"title":"Connect Phished.io","icon":"shield-halved","href":"/user-guides/integrations/enable-phished-integration"},{"title":"Configure CyberHoot Integration","icon":"graduation-cap","href":"/user-guides/integrations/enable-cyberhoot-integration"},{"title":"Connect Avanan and map customer tenants","icon":"plug","href":"/user-guides/integrations/enable-avanan-integration"},{"title":"Provide Blackpoint Cyber API access","icon":"plug","href":"/user-guides/integrations/enable-blackpoint-cyber-integration"},{"title":"Provide Cisco Umbrella API access","icon":"plug","href":"/user-guides/integrations/enable-cisco-umbrella-integration"},{"title":"Connect DNSFilter and map organizations","icon":"plug","href":"/user-guides/integrations/enable-dnsfilter-integration"},{"title":"Provide Mimecast API access","icon":"plug","href":"/user-guides/integrations/enable-mimecast-integration"},{"title":"Connect ThreatMate and map customers","icon":"plug","href":"/user-guides/integrations/enable-threatmate-integration"},{"title":"Provide VulScan API access","icon":"plug","href":"/user-guides/integrations/enable-vulscan-integration"}]},{"group":"Backup","pages":[{"title":"Configure Cove Backup Integration","icon":"database","href":"/user-guides/integrations/enable-cove-backup-integration"},{"title":"Configure Acronis Cyber Protect Integration","icon":"cloud-arrow-down","href":"/user-guides/integrations/enable-acronis-integration"},{"title":"Configure Spanning Backup Integration","icon":"cloud-arrow-up","href":"/user-guides/integrations/enable-spanning-integration"},{"title":"Configure Kaseya SaaS Protection Integration","icon":"database","href":"/user-guides/integrations/enable-kaseya-saas-protection-integration"},{"title":"Connect Datto Backup","icon":"plug","href":"/user-guides/integrations/enable-datto-backup-integration"},{"title":"Connect NinjaOne SaaS Backup","icon":"plug","href":"/user-guides/integrations/enable-ninjaone-saas-backup-integration"},{"title":"Connect Slide Backup","icon":"plug","href":"/user-guides/integrations/enable-slide-integration"}]},{"group":"Documentation and client portals","pages":[{"title":"Configure Hudu Integration","icon":"book","href":"/user-guides/integrations/enable-hudu-integration"},{"title":"Configure IT Glue Integration","icon":"book","href":"/user-guides/integrations/enable-itglue-integration"},{"title":"Sync IT Glue Document Folders","icon":"shield-halved","href":"/user-guides/integrations/itglue-sync-folders"},{"title":"Configure Liongard Integration","icon":"magnifying-glass-chart","href":"/user-guides/integrations/enable-liongard-integration"},{"title":"Configure CloudRadial Integration","icon":"cloud","href":"/user-guides/integrations/enable-cloudradial-integration"}]},{"group":"Cloud and domains","pages":[{"title":"Connect rollout companies to Microsoft 365","sidebarTitle":"Connect rollout companies to Microsoft 365","icon":"cloud","href":"/user-guides/getting-started/onboarding/company-m365"},{"title":"Security of MSPortal's Microsoft apps","sidebarTitle":"Microsoft app security","icon":"shield-check","href":"/user-guides/integrations/microsoft-app-security"},{"title":"Connect Google Workspace","icon":"google","href":"/user-guides/integrations/enable-google-workspace-integration"},{"title":"Configure CIPP Integration","icon":"cloud","href":"/user-guides/integrations/enable-cipp-integration"},{"title":"Configure Pax8 Integration","icon":"boxes-stacked","href":"/user-guides/integrations/enable-pax8-integration"},{"title":"Set Up Pax8 for Subscriptions and Storefront","icon":"plug","href":"/user-guides/licensing/setup"},{"title":"Configure Sherweb Integration","icon":"cloud","href":"/user-guides/integrations/enable-sherweb-integration"},{"title":"Configure Adobe Enterprise Integration","icon":"file-pdf","href":"/user-guides/integrations/enable-adobe-enterprise-integration"},{"title":"Configure Intermedia Integration","icon":"phone","href":"/user-guides/integrations/enable-intermedia-integration"},{"title":"Configure DNSimple Integration","icon":"globe","href":"/user-guides/integrations/enable-dnsimple-integration"},{"title":"Configure Cloudflare Integration","icon":"plug","href":"/user-guides/integrations/enable-cloudflare-integration"},{"title":"Provide Ingram Micro API access","icon":"plug","href":"/user-guides/integrations/enable-ingram-micro-integration"},{"title":"Provide TD SYNNEX API access","icon":"plug","href":"/user-guides/integrations/enable-td-synnex-integration"}]},{"group":"Sales, payments and scheduling","pages":[{"title":"Connect and manage Quoter","icon":"plug","href":"/user-guides/quotes/setup"},{"title":"Troubleshoot missing Quoter quotes and company links","icon":"magnifying-glass","href":"/user-guides/quotes/troubleshoot-quoter-quotes"},{"title":"Configure QuoteWerks Integration","icon":"file-invoice-dollar","href":"/user-guides/integrations/enable-quotewerks-integration"},{"title":"Map QuoteWerks customers to companies","icon":"file-invoice-dollar","href":"/user-guides/integrations/map-quotewerks-customers"},{"title":"Troubleshoot QuoteWerks quotes and QuoteValet links","icon":"file-invoice-dollar","href":"/user-guides/quotes/troubleshoot-quotewerks-quotes"},{"title":"Configure Salesbuildr Integration","icon":"file-invoice-dollar","href":"/user-guides/integrations/enable-salesbuildr-integration"},{"title":"Map Salesbuildr companies for quote access","icon":"file-invoice-dollar","href":"/user-guides/integrations/map-salesbuildr-companies"},{"title":"Troubleshoot Salesbuildr quotes and PDFs","icon":"file-invoice-dollar","href":"/user-guides/quotes/troubleshoot-salesbuildr-quotes"},{"title":"Configure HubSpot Integration","icon":"handshake","href":"/user-guides/integrations/enable-hubspot-integration"},{"title":"Configure Benji Pays Integration","icon":"credit-card","href":"/user-guides/integrations/enable-benjipays-integration"},{"title":"Configure TimeZest Integration","icon":"calendar-clock","href":"/user-guides/integrations/enable-timezest-integration"},{"title":"Configure Simplesat Integration","icon":"face-smile","href":"/user-guides/integrations/enable-simplesat-integration"},{"title":"Configure SmileBack Integration","icon":"face-smile-beam","href":"/user-guides/integrations/enable-smileback-integration"},{"title":"Configure Microsoft Teams Integration","icon":"microsoft","href":"/user-guides/integrations/enable-teams-integration"},{"title":"Provide CrewHu API access","icon":"plug","href":"/user-guides/integrations/enable-crewhu-integration"},{"title":"Connect Fellow meeting notes","icon":"plug","href":"/user-guides/integrations/enable-fellow-integration"}]}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/budgets/list-budgets"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes"}]}]},"basePath":"","title":"Configure Autotask PSA Integration - MSPortal.ai Documentation","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DevImLcx.js","DynamicMarkdown-BGHukeRM.js","zoom-image-lightbox-DQG3o8Eu.js","lightbox-handle-r17bVUz3.js"]}