> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up the Autotask PSA Ticketing Integration

> Step-by-step guide to create the Autotask API user, security level, and webhook permissions Thread needs to sync tickets, contacts, and time entries.

This guide explains how to set up the Autotask Integration in the platform.

During the initial setup of your account in the platform, you are prompted to set up your ticketing system. Following the prompts for Autotask will lead you to the following screen asking you to enter API credentials.

<Steps>
  <Step title="Leave this screen open.">
    Leave this screen open, we will come back to it later.

    <Frame>
      <img src="https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/a3ce6c23-2023-08-29-14-11-19.png?fit=max&auto=format&n=ysyi1-ysJ96KyxOf&q=85&s=2183a73c000ff81f90d7358940b221aa" alt="Autotask API credentials entry screen in the platform setup" width="568" height="693" data-path="images/a3ce6c23-2023-08-29-14-11-19.png" />
    </Frame>
  </Step>

  <Step title="Open a new browser tab to configure the API user.">
    Open a new browser tab or window to continue to the next step, configuring the API user.
  </Step>
</Steps>

## 1. Configure the Security Level for the API User

<Steps>
  <Step title="Log-in to Autotask.">
    Log-in to Autotask:

    <Frame>
      <img src="https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/b883ba5a-1.png?fit=max&auto=format&n=MmA6qEMELRi-vXeU&q=85&s=5b5b59bd668a2b00994951b348a7e8f9" alt="Autotask login screen" width="468" height="500" data-path="images/b883ba5a-1.png" />
    </Frame>
  </Step>

  <Step title="Open Admin → Account Settings & Users.">
    Go to **Admin** section of the menu and open **Account Settings & Users** page

    <Frame>
      <img src="https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/83a9f700-image.png?fit=max&auto=format&n=ysyi1-ysJ96KyxOf&q=85&s=45b09f0c46593dff2dbd8ebd727113b9" alt="Admin menu with Account Settings & Users in Autotask" width="673" height="766" data-path="images/83a9f700-image.png" />
    </Frame>
  </Step>

  <Step title="Select Security Levels.">
    Select **Security Levels** item from **Resources/Users (HR)** -> **Security** section

    <Frame>
      <img src="https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/ccf1c091-image.png?fit=max&auto=format&n=MmA6qEMELRi-vXeU&q=85&s=2d653af3d1776d004088c619e278eb52" alt="Security Levels under Resources/Users Security section" width="569" height="672" data-path="images/ccf1c091-image.png" />
    </Frame>
  </Step>

  <Step title="Copy the API User (system) (API-only) role.">
    Select **Copy** item from the menu of **API User (system) (API-only)** role

    <Frame>
      <img src="https://mintcdn.com/thread/yMrisProrR453qj0/images/1f777d14-image.png?fit=max&auto=format&n=yMrisProrR453qj0&q=85&s=c7a6830713a4c7406ffcfd183dcd88fa" alt="Copy option on the API User system role menu" width="499" height="579" data-path="images/1f777d14-image.png" />
    </Frame>
  </Step>

  <Step title="Change the Name field.">
    On the opened window, change **Name** field to "*API User (system) with Webhooks*"

    <Frame>
      <img src="https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/dca1e37a-image.png?fit=max&auto=format&n=MmA6qEMELRi-vXeU&q=85&s=b06731c285bc524971e4d8ab65efe394" alt="Renaming the copied security level in Autotask" width="728" height="557" data-path="images/dca1e37a-image.png" />
    </Frame>
  </Step>

  <Step title="Enable Can create Webhooks and set the maximum to 50.">
    Then go to the **Other** section and enable Can create Webhooks setting. Make sure to write 50 to the "Maximum number of Webhooks" field

    <Frame>
      <img src="https://mintcdn.com/thread/2AdmqP0mlnyoZLRc/images/fb0dad78-image.png?fit=max&auto=format&n=2AdmqP0mlnyoZLRc&q=85&s=0dffe92232d591e68cb819dcf38e42ce" alt="Can create Webhooks setting with maximum set to 50" width="848" height="305" data-path="images/fb0dad78-image.png" />
    </Frame>
  </Step>

  <Step title="Enable Resource and Contact Impersonation permissions.">
    Next, navigate to the **Web Services API** section. Under **Resource Impersonation**, check all the permissions indicated in the screenshot below. Do the same for **Contact Impersonation**.These settings are used to impersonate your users so if they respond to a customer via Inbox, Teams or Slack, the notes update as them in Autotask. In a later step, we will also configure your user security levels so that the API user we create here can impersonate them.

    <Frame>
      <img src="https://mintcdn.com/thread/2AdmqP0mlnyoZLRc/images/fee7df51-image-20221025-131251.png?fit=max&auto=format&n=2AdmqP0mlnyoZLRc&q=85&s=4e7fb8b9be8f3d5aeac057d9c315bdad" alt="Resource and Contact Impersonation permissions under Web Services API" width="1360" height="1760" data-path="images/fee7df51-image-20221025-131251.png" />
    </Frame>

    <Warning>
      Before proceeding, please make sure all settings above are selected for this security level.
    </Warning>
  </Step>

  <Step title="Save & Close, then return to Account Settings & Users.">
    Once all the impersonation settings are configured, click **Save & Close** button to save the role. After that, click **Back** button to return to the **Account Settings & Users** page

    <Frame>
      <img src="https://mintcdn.com/thread/2AdmqP0mlnyoZLRc/images/f9fb74ec-image.png?fit=max&auto=format&n=2AdmqP0mlnyoZLRc&q=85&s=73fdfd0ffd17a4df2806e457c77bbe7d" alt="Save & Close on the security level in Autotask" width="456" height="412" data-path="images/f9fb74ec-image.png" />
    </Frame>
  </Step>
</Steps>

## 2. Configure User Security Levels

In this section, you will need to reconfigure the security levels that each of your users are assigned to so that the platform can effectively impersonate these users for Service notes, time entries and more.

<Note>
  This is what allows the user responses to customers from Inbox, Teams and Slack to show up as the user in Autotask rather than as the API account.
</Note>

The security level for each user that is going to respond to tickets in Inbox, Teams or Slack will need to be configured to allow for resource impersonation.

<Tip>
  We recommend configuring this setting on all security levels that are in use by users in your Autotask environment in order to prevent errors.
</Tip>

<Steps>
  <Step title="Navigate to Security Levels.">
    In Autotask, Navigate to **Admin** -> **Account Settings & Users** -> **Security** -> **Security Levels**
  </Step>

  <Step title="Filter the Active column to Yes (active).">
    Change the filter on the **Active** column to **Yes (active)**
  </Step>

  <Step title="Identify the security levels that have resources assigned.">
    Each security level in the list will show how many resources are assigned to each. You only need to update each security level that has a resource assigned. API type security levels do not need to be updated, only security levels assigned to active users.

    <Frame>
      <img src="https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/9313aee3-2022-10-26-12-28-18.png?fit=max&auto=format&n=ysyi1-ysJ96KyxOf&q=85&s=7d44b7368f93d407acb5c9413b886d97" alt="Security Levels list showing resource counts in Autotask" width="1394" height="661" data-path="images/9313aee3-2022-10-26-12-28-18.png" />
    </Frame>
  </Step>

  <Step title="Select the first in-use resource.">
    Start by selecting the first resource on the list that is in use and assigned to 1 or more resources.
  </Step>

  <Step title="Edit that security level.">
    For that resource, click the menu button on the left (or right-click on it) and select **Edit**

    <Frame>
      <img src="https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/8441feb5-2022-10-26-12-32-23.png?fit=max&auto=format&n=ysyi1-ysJ96KyxOf&q=85&s=c43cb35251f95ae7963bda2f656f15ba" alt="Edit option on a security level in Autotask" width="240" height="193" data-path="images/8441feb5-2022-10-26-12-32-23.png" />
    </Frame>
  </Step>

  <Step title="Allow impersonation of resources with this security level.">
    A window to edit that security level will pop up, scroll down to the Web Services API section and expand. Under Web Services **API** -> **Resource Impersonation** -> Check the box for **Allow Impersonation of resources with this security level**.

    <Frame>
      <img src="https://mintcdn.com/thread/yMrisProrR453qj0/images/03c5115d-2022-10-26-12-34-37.png?fit=max&auto=format&n=yMrisProrR453qj0&q=85&s=28ad43bd7c169fbbdaea5ad8d19c6ed2" alt="Allow Impersonation of resources checkbox under Web Services API" width="1045" height="267" data-path="images/03c5115d-2022-10-26-12-34-37.png" />
    </Frame>
  </Step>

  <Step title="Click Save & Close.">
    Click **Save & Close**.
  </Step>

  <Step title="Repeat for each applicable security level.">
    **Repeat steps 4-7** for each Security Level on the list that is assigned to a resource and not an API User type.
  </Step>
</Steps>

## 3. Create the Ticket Source

The ticket source is used for reporting to allow you to distinguish tickets created via the platform/chat from other tickets.

<Steps>
  <Step title="Navigate to Sources.">
    In Autotask, Navigate to **Admin** -> **Features & Settings** -> **Service Desk (Tickets)** -> **Sources**
  </Step>

  <Step title="Create a new Source.">
    Click the **+ New** button to create a new Source

    <Frame>
      <img src="https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/6c604062-2022-10-26-12-55-40.png?fit=max&auto=format&n=ysyi1-ysJ96KyxOf&q=85&s=253f9762d3acdf86093020528d7d5142" alt="+ New button on the Autotask Sources page" width="924" height="484" data-path="images/6c604062-2022-10-26-12-55-40.png" />
    </Frame>
  </Step>

  <Step title="Name the source Chat and mark it Active.">
    Enter in the **Source Name** "Chat", enter a number for the **Source Sort Order** (this can be whatever you want) and check the **Active** box.

    <Frame>
      <img src="https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/69452b77-2022-10-26-14-34-42.png?fit=max&auto=format&n=ysyi1-ysJ96KyxOf&q=85&s=ed4b911cc7e0ec24d747888b38cd06c1" alt="New source form with Source Name Chat and Active checked" width="878" height="508" data-path="images/69452b77-2022-10-26-14-34-42.png" />
    </Frame>
  </Step>

  <Step title="Click Save.">
    Click **Save** when done.
  </Step>
</Steps>

## 4. Create the API User

<Steps>
  <Step title="Open the Resources/Users page.">
    Open the **Resources/Users** page from **Resources/Users (HR)** section

    <Frame>
      <img src="https://mintcdn.com/thread/yMrisProrR453qj0/images/21345ad6-image.png?fit=max&auto=format&n=yMrisProrR453qj0&q=85&s=d885544f3c371fc10e23e4df28522b78" alt="Resources/Users page in Autotask" width="661" height="528" data-path="images/21345ad6-image.png" />
    </Frame>
  </Step>

  <Step title="Select New API User.">
    Select "New API User" button from "New" button dropdown.

    <Frame>
      <img src="https://mintcdn.com/thread/2AdmqP0mlnyoZLRc/images/ff2ef246-image.png?fit=max&auto=format&n=2AdmqP0mlnyoZLRc&q=85&s=e7eeb493dcfe8b1303388fb25b8bba75" alt="New API User option in the New button dropdown" width="430" height="439" data-path="images/ff2ef246-image.png" />
    </Frame>
  </Step>

  <Step title="Fill required fields and set the Security Level.">
    In the opened page fill all required fields with self-explanatory values. Make sure to select "API User (system) with Webhooks" in "Security Level" field.

    <Frame>
      <img src="https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/75544c15-image.png?fit=max&auto=format&n=ysyi1-ysJ96KyxOf&q=85&s=f68f11653b8feae2622372746b159007" alt="New API user form with Security Level set to API User system with Webhooks" width="1044" height="580" data-path="images/75544c15-image.png" />
    </Frame>
  </Step>

  <Step title="Generate the Key and Secret.">
    Click "Generate Key" and "Generate Secret" buttons in "CREDENTIALS" section. Store generated values somewhere as it will be required later for the integration.

    <Frame>
      <img src="https://mintcdn.com/thread/ysyi1-ysJ96KyxOf/images/594dea2f-image.png?fit=max&auto=format&n=ysyi1-ysJ96KyxOf&q=85&s=adcbdc8f904ab86ed995be49044d178d" alt="Generate Key and Generate Secret buttons in the Credentials section" width="1049" height="233" data-path="images/594dea2f-image.png" />
    </Frame>
  </Step>

  <Step title="Select the Thread - Messaging integration vendor.">
    Select the "Integration Vendor" option from the list and select "Thread - Messaging" from the drop down list.

    <Frame>
      <img src="https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/e91bc5d3-image.png?fit=max&auto=format&n=MmA6qEMELRi-vXeU&q=85&s=56862ca8b25c1e87c6e30d002596df99" alt="Integration Vendor dropdown with Thread - Messaging selected" width="719" height="258" data-path="images/e91bc5d3-image.png" />
    </Frame>
  </Step>

  <Step title="Grant lines of business access.">
    From the "LINE OF BUSINESS" section, select one or many (or all) lines of business to grant the access to the integration account.

    <Frame>
      <img src="https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/a4c07b0b-image.png?fit=max&auto=format&n=MmA6qEMELRi-vXeU&q=85&s=85251f55b4ed498b104c78bee40cc25b" alt="Line of Business selection for the API user" width="1047" height="346" data-path="images/a4c07b0b-image.png" />
    </Frame>
  </Step>

  <Step title="Click Save & Close.">
    Click the "Save & Close" button.
  </Step>
</Steps>

## 5. Configure Thread with the API Information

Now that you've set up your API keys, it's time to integrate Autotask with Thread! It's time to take the information you saved in the previous steps and enter it into the web form.

<Frame>
  <img src="https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/bf9bb88a-2023-08-29-14-11-19.png?fit=max&auto=format&n=MmA6qEMELRi-vXeU&q=85&s=508a86f0ff80926f842787e4e8dabfec" alt="Thread Autotask integration credentials web form" width="568" height="693" data-path="images/bf9bb88a-2023-08-29-14-11-19.png" />
</Frame>

<Steps>
  <Step title="Enter your Company Name.">
    **Company Name** - Enter your company name
  </Step>

  <Step title="Enter the Username (Key).">
    **Username (Key)** - Enter the Username (Key) that you saved in step **4.3 Create the API User**.
  </Step>

  <Step title="Enter the Password (Secret).">
    **Password (Secret)** - Enter the Password (Secret) that you saved in step **4.3 Create the API User**.
  </Step>

  <Step title="Choose whether to keep members in sync with PSA.">
    **Keep members in sync with PSA**

    1. Leave this checked to quickly enable your team's access to thread.
    2. Uncheck this if you prefer to invite members individually. If you choose this option, you will be able to invite members later.
  </Step>

  <Step title="Click Continue.">
    Once everything has been entered correctly, click **Continue** to proceed.
  </Step>
</Steps>

## Next: Design your Customer Experience

<Card title="Design your customer chat experience" icon="comments" href="/messenger/configurations-in-messenger">
  Set up and personalize Thread Messenger for your clients.
</Card>

<Note>
  See **Integrations** updates in the [changelog](/changelog/q3-2026).
</Note>


## Related topics

- [Set Up the HaloPSA Ticketing Integration](/integrations/how-to-setup-halo-psa-integration.md)
- [Set Up the ConnectWise PSA Ticketing Integration](/integrations/creating-a-connect-wise-manage-api-user.md)
- [Enable Thread Chat & Timepad Insights in Autotask](/integrations/how-to-enable-chat-and-timepad-insights-in-autotask.md)
