<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 | Read Only | Is Required | Reference Name | Is supported Webhook Field? |
---|---|---|---|---|---|
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.
|
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.
|
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>