<EntityName>WebhookUdfFields (REST API)

This article describes the WebhookUdfFields entity for the Autotask REST API. For the SOAP API equivalent of this webhook, refer to <EntityName>WebhookUdfField (SOAP API).

Overview

This entity names a user-defined field (UDF) that, when updated, will either trigger a webhook call or is always included with the payload of the webhook. At least one callout field (WebhookField or WebhookUdfField) is required to make a create or update call.

Entity details

You can also retrieve this information with the GET and POST REST API calls.

Entity Name: <EntityName>WebhookUdfFields
Can Create:
Can Update:
Can Query:
Can Delete:
Can Have UDFs:  
SOAP REST
Account Companies
AccountLocation CompanySiteConfigurations
Contact Contacts
Contract Contracts
InstalledProduct ConfigurationItems
Opportunity Opportunities
Product Products
Project Projects
SalesOrder SalesOrders
 

ServiceBundles

 

Services

Subscription Subscriptions
Task Tasks
Ticket Tickets

Each entity has a maximum number of active user-defined fields that you can define. For more information, refer to Managing user-defined fields.

IMPORTANT  You can only query by one user-defined field at a time.

To learn how to make PUT, PATCH, and POST requests to entities that support UDFs, refer to Creating resources via POST request in the REST API, Updating data via PUT request with the REST API and Updating data via PATCH request with the REST API.

Fields

Field Name

Label and Description

 Datatype Read Only Is Required Reference Name Picklist?

Id

This field contains the webhook identifier for a UDF that triggers a callout or is part of the payload.

NOTE  Use a query call to get the ID value to use.

 long    

IsDisplayAlwaysField

The value of this field is true if the API adds the field to the payload when another field triggers a callout.

NOTE  Include external IDs as Display Always fields to facilitate cross-referencing with the client application.

 boolean      

IsSubscribedField

The value of this field is true if a change to the field triggers a callout.

 boolean      

UdfFieldID

This value is the internal Autotask ID for the user-defined field.

 integer  

WebhookID

This value represents the internal ID assigned to a webhook. It is always prefaced with the name of the entity.

EXAMPLE  Account Webhook ID

 integer   <EntityName>Webhook (SOAP API)