How to Set Up User-Defined Fields (UDFs) in Autotask for Approvals

Updated by Bryan Chapman

Overview

This guide explains how to create a User-Defined Field (UDF) in Autotask, assign it to contacts, and configure Thread to use approvals.

Approvals can be used in the following:

Feature

Description

Thread Inbox

Manually trigger or cancel an approval directly within Thread Inbox or Pods/Insights.

Triage Agent

Automatically send approval requests directly within an intent with Triage Agent.

Step 1: Create a Contact UDF in Autotask

  1. Login to Autotask PSA.
  2. Click on Admin in the top navigation bar.
  3. Select User-Defined Fields (UDFs) under Application-Wide (Shared) Features.
  4. Click on the Contacts tab.
  5. Click New to create a new UDF.
  6. Enter a Name: (e.g., Approval Role)
  7. Field Type: Select List (Single Select)
  8. Under the List Options click New to add Contact Types and define approval roles, such as:

    Approval Role

    Description

    Approver

    Reviews and approves or denies requests.

    Finance

    Reviews and approves requests related to budgets, expenses, and financial impact.

    Procurement

    Reviews and approves vendor, contracts, and purchasing requests.

    Human Resources

    Reviews and approves new hire, termination and other human resource related requests.

    Change Advisory Board (CAB)

    A committee that reviews and approves system-wide IT changes.

  9. Click Save & Close to save the new UDF.

Step 2: Assign the UDF to Contacts in Autotask

  1. Login to Autotask PSA.
  2. Go to CRM > Contacts in Autotask.
  3. Search for and select the contact.
  4. Find the newly created Approval Role UDF field.
  5. Choose the correct role from the dropdown (e.g., Approver, Procurement).
  6. Click Save & Close.

Step 3: Sync Data from Autotask to Thread

Note Contacts are automatically updated in Thread. However, you will need to force sync Contact Types by following the steps below:
  1. Login to the Thread admin panel.
  2. Go to the PSA Sync tab.
  3. Click Force Sync next to Contact Types.
  4. Wait for the sync to complete.

Once completed, Thread will now recognize the Approval Role UDF and use it for the approvals workflow.

Step 4: Configure Thread to Use the UDF for Approvals

  1. Login to the Thread admin panel.
  2. Click Admin > Integrations > PSA > Settings.
  3. Locate the Approval Field setting.
  4. Select the UDF you created in Autotask (e.g., Approval Roles).
  5. Click Save Changes.

Completion

  • Check a request in Thread to ensure that approvals are assigned correctly.
  • If the UDF is not showing, verify that the Autotask-Thread sync was successful.
  • If issues persist, reach out to support.


How did we do?