getUDFInfo()

IMPORTANT  The SOAP API entered a limited enhancement phase in Q4 2020. Access deactivation for version 1.5 began in Q1 2022 and will enter its concluding phases in October 2022. Access to version 1.6 will be deactivated in Q4 2024. Visit our SOAP API lifecycle FAQ article to learn more.

This API call is an informational Web Service that returns an array of all user-defined fields (UDF), that is, non-standard fields, for a specified entity. Currently, the following Autotask entities can include UDFs: Account, AccountLocation, Contact, Contract, InstalledProduct, Opportunity, Product, Project, SalesOrder, Task, Ticket.

getUDFInfo() returns the following information for each field.

Data Description
Name as String Name of the field element, this is not what you see on the UI.
Label as String Name of the field on the UI.
Type as String The field element data type

String: Can contain alpha-numeric and most special characters (note: some fields have specific lengths)
Double: Like Integer but can contain decimal places
dateTime: Contains the date and time as one value like a time stamp
Date: Date only, no time
Boolean: True (Yes) (1) or False (No) (0)
Description as String The long Description of the field element.
IsRequired as Boolean True or False. Returns True (Yes) if the element is required to update or create.
IsReadOnly as Boolean True or False. Returns True (Yes) if the element cannot be updated or created.
IsQueryable as Boolean True or False. Returns True (Yes) if the element can be searched on.
IsReference as Boolean True or False. Returns True (Yes) if the field contains the ID value of another entity type.
ReferenceEntityType as String If the element IsReference is True (Yes), indicates the Entity Type of the reference.
IsPicklist as Boolean True or False. Returns True (Yes) if the element is a picklist, specifically a drop-down list.
PickListValues() as PickListValue If IsPicklist = True, then this will hold the values of the Drop Down List.
The picklist values elements include the following:

Value as StringThe picklist value of the item.
Label as StringThe name of the item as it appears in the drop-down list.
IsDefault as BooleanIndicates whether the item is the default value for the field.
SortOrder as BooleanIndicates the order of the items as they appear in the list.
ParentValue as StringIf the picklist is a child of another field, identifies the parent field.
IsSupportedWebhookField True or False. Reflects whether the field is a webhook-capable field that can either trigger a callout or is always part of the information (payload) sent to the WebhookURL.

Sample getUDFInfo() SOAP XML

            <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <AutotaskIntegrations xmlns="http://autotask.net/ATWS/v1_6/">
      <IntegrationCode>[insert your own tracking identifier]</IntegrationCode>
    </AutotaskIntegrations>
  </soap:Header>
  <soap:Body>
    <getUDFInfo xmlns="http://autotask.net/ATWS/v1_6/">
     <psTable>Account</psTable>
    </getUDFInfo >
  </soap:Body>
</soap:Envelope>