<EntityName>Webhook (SOAP API)

This entity describes the fields that populate to generate a webhook for an entity in the Autotask SOAP API. For the REST API equivalent of this webhook, refer to <EntityName>Webhooks (REST API).

Overview

You can subscribe a callout to one of the callout types (Create, Update or Delete), or up to all three of them. When a callout subscribes to multiple types, they will share a single Webhook URL and Webhook ID.

Supported entities

The following Autotask entities currently support webhooks:

Companies (Accounts)
Contacts
Assets (Configuration Items)
Tickets, including tickets created in Taskfire (REST only)
Ticket Notes, including ticket notes created in Taskfire (REST only)

We will continuously add webhook support to additional entities.

Entity details

You can also retrieve this information with the Web Services API call The getEntityInfo() SOAP API call.

Entity Name:	<EntityName>Webhook
Can Create:
Can Update:
Can Query:
Can Delete:
Can Have UDFs:

Fields

Field Name Label and Description	Datatype	Reference Name
Active Active You can create webhooks with an Active setting of True or False. No callouts will occur if a webhook is inactive.	boolean
Deactivationurl Deactivation URL This field contains a separate URL that the API calls when the webhook (not the entity) is deleted or inactivated. This call will happen when the resource who created the webhook becomes deleted or deactivated.	string (500)
id <EntityName> Webhook Configuration ID The data contained in this field is the webhook configuration ID. Webhooks receive an ID that is unique for the database and each entity. EXAMPLE The first webhook you create for the Account entity has ID = 1. Numbering is sequential.	long
IsSubscribedToCreateEvents Is Subscribed To Create Events The condition is true if this webhook triggers as the result of an entity's creation. The condition is blank or false if this webhook does not trigger as the result of an entity's creation.	boolean
IsSubscribedToDeleteEvents Is Subscribed To Delete Events True if this webhook is triggered by an entity being deleted. Blank or false if this webhook is not triggered by an entity being deleted.	boolean
IsSubscribedToUpdateEvents Is Subscribed To Update Events The condition is true if this webhook triggers as the result of entity fields updating. The condition is blank or false if the webhook does not trigger as the result of an entity's fields updating.	boolean
Name Name This field holds the name of the webhook. The name will appear in the subject line of error and notification emails. A best practice is to use a name that includes the integration name, the entity name and the event that will trigger the callout. EXAMPLE Marketo.Contact.Update	string (50)
NotificationEmailAddress Notification Email Address This value is an email address that receives notification of any error or alert, in addition to the email address associated with the API user authentication credentials.	string (150)
OwnerResourceID Owner Resource ID This value is the Autotask resource ID of the API user. It is automatically tracked with the callout. Each callout owner can only access and manage their own callouts in the API. The intent is to let an integration vendor create and manage their own callouts and not see any other callouts they don’t own. Any notifications that go to the callout notification email address are also copied to the callout owner. Callouts will continue to execute while the owner is locked out or a password is expired. If the callout owner's user account is inactivated, all callouts owned by that username deactivate with a callout to the Deactivation URL.	integer	Resource
Ready Ready This field is a read-only value that is set to true when the webhook is completely set up.	boolean
SecretKey Secret Key The recipient of the webhook call needs to confirm the legitimacy and integrity of the callout. You can do so by using a secret key known to both the sender and the recipient. Any combination of letters, number and symbols will work. We recommend a strong key with at least 10 digits. Refer to Secret key and payload verification.	string (64)
SendThresholdExceededNotification Send Threshold Exceeded Notification You can chose to received notification when the Webhook callout requests per hour per entity threshold has been exceeded. Threshold exceeded is not an error condition, but it can deliver a warning if this callout flag's status is True and a notification email address is available to the callout. A notification email would transmit once delivery is delayed, and again when callouts are caught up. The initial message will include the time delay. The API will only send the second email if the first one was sent.	boolean
WebhookGUID Webhook GUID GUID stands for Globally Unique Identifier. The value is a webhook ID that is unique across all Autotask databases.	string (100)
WebhookUrl Webhook URL This value is the URL to which webhook callouts will be posted by the API. It is a web service that listens to outbound calls from Autotask.	string (500)

Sample request

Here is a sample SOAP request for a webhook that would fire if an account was modified:

<?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>INSERTYOUROWN</IntegrationCode>
    </AutotaskIntegrations>
  </soap:Header>
  <soap:Body>
    <create xmlns="http://autotask.net/ATWS/v1_6/">
      <Entities>
        <Entity xsi:type="AccountWebhook" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
          <Active>True</Active>
          <DeactivationUrl>https://enkmoj676nwh8.x.pipedream.net</DeactivationUrl>
          <IsSubscribedToUpdateEvents>True</IsSubscribedToUpdateEvents>
          <Name>Angela.Accounts.Modify</Name>
          <SecretKey>20201</SecretKey>
          <WebhookUrl>https://enymf79yfhr0d.x.pipedream.net</WebhookUrl>
        </Entity>
      </Entities>
    </create>
  </soap:Body>

	Need troubleshooting help? Open the Kaseya Helpdesk.
	Want to talk about it? Head on over to the Community!
	Have an idea for a new feature? Want to learn about upcoming enhancements? Visit the Ideas forum!
	Provide feedback for the Documentation team.