# List of Enate's Webhooks

The following Webhooks are currently available in Enate:

* [PacketCreated](/enate-help/integrations/enate-integrations/webhooks/enates-webhooks.md#packet-created) - fires when a Ticket, Case or Action is created.&#x20;
* [PacketUpdated](/enate-help/integrations/enate-integrations/webhooks/enates-webhooks.md#packet-updated) - fires when a Ticket, Case or Action is updated.
* [NewCommunication](/enate-help/integrations/enate-integrations/webhooks/enates-webhooks.md#newcommunication) - fires when a communication (email or note) is added to a specific work item
* [BusinessObjectCreated](/enate-help/integrations/enate-integrations/webhooks/enates-webhooks.md#businessobjectcreated) - fires when a COMPANY or a SCHEDULE is created.
* [BusinessObjectUpdated](/enate-help/integrations/enate-integrations/webhooks/enates-webhooks.md#businessobjectupdated) - fires when a COMPANY or a SCHEDULE is updated.
* [SpecificBusinessObjectUpdated](/enate-help/integrations/enate-integrations/webhooks/enates-webhooks.md#businessobjectupdated-1) - fires when a COMPANY or a SCHEDULE, specified within the subscription, is updated.

The sections below give details for the webhooks you can currently subscribe to, a short description of the events which will trigger them, the data you'll get returned from the webhook (with example values for each) and the parameters which are to be passed in.

{% hint style="info" %}
Note that the term 'Packet' here refers to Enate's Work Items - which can be of type Case, Action or Ticket.
{% endhint %}

## Packet Created <a href="#packet-created" id="packet-created"></a>

| **Name**                | Packet Created                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Related events**      | Creation of any work item i.e. Case, Action, Ticket                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Message returned**    | <p>Returns basic packet information in JSON format: </p><p>{</p><p> "<strong>CustomerName</strong>": the name of the customer e.g. "Globex Corporation",</p><p> "<strong>SupplierName</strong>": the name of the supplier e.g. "Initech",</p><p> "<strong>ContractName</strong>": the name of the contract e.g. "Capital Discovery",</p><p> "<strong>ServiceName</strong>": the name of the service e.g. "HR Relief",</p><p> "<strong>ServiceLineName</strong>": the name of the service line e.g. "East Coast",</p><p> "<strong>ProcessTypeName</strong>": the name of the process type e.g. "Start Employee",</p><p> "<strong>Reference</strong>": this is a system generated identifier for a packet, it follows Enate’s own formatting e.g. "202234-C",</p><p> "<strong>Title</strong>": the title of the packet. This is not set until the packet is submitted when it is set by the user (or whatever is creating the packet) – newly created packets won’t have it yet e.g. “Standard Appeal”,</p><p> "<strong>Status</strong>": the status of the packet. Draft = 0, ToDo = 1, InProgress = 2, Waiting = 3, Resolved = 4, Closed = 5</p><p> "<strong>DueDate</strong>": this is not set until the packet is submitted – newly created packets won’t have it yet e.g. null</p><p> "<strong>RAGStatus</strong>": the RAG status of the packet, e.g. 1. ToBeDetermined = -2, Overdue = -1, DueToday = 0, DueInFuture = 1</p><p> "<strong>ProcessType</strong>": the process type, e.g. 1. Case = 1, Ticket = 2, Action = 3</p><p> "<strong>GUID</strong>": the Webhook GUID e.g. "215d6b04-f587-eb11-b9ad-e86a64437383"</p><p>}</p> |
| **Parameters required** | <p> "<strong>Webhook</strong>": name of the WebHook being subscribed to i.e. PacketCreated</p><p> "<strong>FilterObjectGUID</strong>": mandatory filter of identifying GUID for either</p><p>· Company (customer)</p><p>· Contract</p><p>· Service or</p><p>· Case/Ticket Process</p><p> "<strong>FilterObjectType</strong>": ID for the type of object being filtered by i.e.</p><p>    · Company = 31</p><p>    · Contract = 215</p><p>    · Service = 217</p><p>    · Process = 911</p><p> "<strong>SubscriberURL</strong>": a valid URL (inc. http/https") which can receive the WebHook message</p><p> "<strong>CustomHeader</strong>":  optional field which adds a custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process. i.e. New-packet-subscription</p><p> "<strong>CustomHeaderValue</strong>": optional field which adds a corresponding value to the custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. New packet created for Globex Corporation"</p>                                                                                                                                                                                                                                    |
| **Restrictions**        | The user account creating the subscription must have permission to access data related to the requested entity (Customer, Contract etc.)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

## Packet Updated <a href="#packet-updated" id="packet-updated"></a>

| **Name**                | **PacketUpdated**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Related events**      | Updates to a specified work item                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Message returned**    | <p>Returns basic packet information in JSON format: </p><p>{</p><p> "<strong>CustomerName</strong>": the name of the customer e.g. "Globex Corporation",</p><p> "<strong>SupplierName</strong>": the name of the supplier e.g. "Initech",</p><p> "<strong>ContractName</strong>": the name of the contract e.g. "Capital Discovery",</p><p> "<strong>ServiceName</strong>": the name of the service e.g. "HR Relief",</p><p> "<strong>ServiceLineName</strong>": the name of the service line e.g. "East Coast",</p><p> "<strong>ProcessTypeName</strong>": the name of the process type e.g. "Start Employee",</p><p> "<strong>Reference</strong>": this is a system generated identifier for a packet, it follows Enate’s own formatting e.g. "202234-C",</p><p> "<strong>Title</strong>": the title of the packet. This is not set until the packet is submitted when it is set by the user (or whatever is creating the packet) – newly created packets won’t have it yet e.g. “Standard Appeal”,</p><p> "<strong>Status</strong>": the status of the packet e.g. "0". Draft = 0, ToDo = 1, InProgress = 2, Waiting = 3, Resolved = 4, Closed = 5</p><p> "<strong>DueDate</strong>": this is not set until the packet is submitted – newly created packets won’t have it yet e.g. "null"</p><p> "<strong>RAGStatus</strong>": the RAG status of the packet e.g. "-2". ToBeDetermined = -2, Overdue = -1, DueToday = 0, DueInFuture = 1</p><p> "<strong>ProcessType</strong>": the process type e.g. "1". Case = 1, Ticket = 2, Action = 3</p><p> "<strong>GUID</strong>": the Webhook GUID e.g. "215d6b04-f587-eb11-b9ad-e86a64437383"</p><p>}</p> |
| **Parameters required** | <p> "<strong>Webhook</strong>": Name of the WebHook being subscribed to i.e. PacketUpdated</p><p> "<strong>FilterObjectGUID</strong>": Mandatory filter of identifying GUID for required packet</p><p> "<strong>FilterObjectType</strong>": "ID for the type of object being filtered by i.e.</p><p>· Packet = 81</p><p> "<strong>SubscriberURL</strong>": "A valid URL (inc. http/https") which can receive the WebHook message</p><p> "<strong>CustomHeader</strong>":  optional field which adds a custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process. i.e. Update-packet-subscription</p><p> "<strong>CustomHeaderValue</strong>": optional field which adds a corresponding value to the custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. Packet 200243-C updated"</p>                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Restrictions**        | The user account creating the subscription must have permission to access data related to the requested packet                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

{% hint style="info" %}
Note: For **Packet Updated** you need to supply a packet GUID, so you would use:

* FilterObjectType = 81 (Packet in the EnateObjects enum)
* FilterObjectGUID = \<any valid PacketGUID you can access>
* WebHook = PacketUpdated
  {% endhint %}

## NewCommunication  <a href="#newcommunication" id="newcommunication"></a>

| **Name**                | **NewCommunication**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Related events**      | New communications added to a specified work item                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Message returned**    | <p>Returns basic communication information in JSON format: </p><p>{</p><p>"<strong>To</strong>": "to" email address</p><p>"<strong>Importance</strong>": 0 = normal, 1 = low,  2 = high</p><p>"<strong>CC</strong>": mail address included in CC</p><p> "<strong>From</strong>": "from" email address if included in the email/message formats</p><p> "<strong>Subject</strong>": pulled from the subject field of the communication, if it has one, e.g. "TPS Reports",</p><p> "<strong>AttachmentCount</strong>": this is the number of attachments on the communication e.g. 30,</p><p> "<strong>GUID</strong>": the Webhook GUID e.g. "31fbfa65-dc39-4c9c-a1f4-47dfef636bea",</p><p> "<strong>PacketGUID</strong>": this identifies the Packet which is being reported on, the GUID in the response when creating a new subscription is the identifier for hat subscription e.g. "878409be-7886-eb11-b9ad-e86a64437383",</p><p> "<strong>CommunicationType</strong>": the communication type used, e.g. 7. EmailOutgoing = 0, PhoneIncoming = 1, EmailIncoming = 2, ESSComment = 3, AuditNote = 4, PhoneOutgoing = 5, LetterIncoming = 6, LetterOutgoing = 7</p><p>}</p>                                           |
| **Parameters required** | <p> "<strong>Webhook</strong>": Name of the WebHook being subscribed to i.e. NewCommunication</p><p> "<strong>FilterObjectGUID</strong>": Mandatory filter of identifying GUID for required packet</p><p> "<strong>FilterObjectType</strong>": "ID for the type of object being filtered by i.e.</p><p>· Packet = 81</p><p> "<strong>SubscriberURL</strong>": "A valid URL (inc. http/https") which can receive the WebHook message</p><p> "<strong>CustomHeader</strong>":  optional field which adds a custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. new-communication</p><p> "<strong>CustomHeaderValue</strong>":optional field which adds a corresponding value to the custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. New communication added to 200243-C"</p> |
| **Restrictions**        | The user account creating the subscription must have permission to access data related to the requested packet                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

{% hint style="info" %}
For **NewCommunication** you need to supply a packet GUID, so you would use:

* FilterObjectType = 81 (Packet in the EnateObjects enum)
* FilterObjectGUID = \<any valid PacketGUID you can access>
* WebHook = NewCommunication

A NewCommunication webhook subscription will result in a message being sent whenever a new communication of any sort (a Note, Incoming Email, Outgoing Email etc.) is added to the specified packet.
{% endhint %}

## BusinessObjectCreated  <a href="#businessobjectcreated" id="businessobjectcreated"></a>

| **Name**                | **BusinessObjectCreated**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Related events**      | A new business object of a specified type is created (Object types **Company** and **Schedule** are provided in this release)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Message returned**    | <p>Returns basic object information in JSON format: </p><p>{</p><p> "<strong>Name</strong>": name is set by the user, e.g. "2022 Schedule",</p><p> "<strong>GUID</strong>": the Webhook GUID e.g. "a3bc0b28-8023-4ac2-a0c4-2144e8a2d659"</p><p>}</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Parameters required** | <p> "<strong>Webhook</strong>": Name of the WebHook being subscribed to i.e. NewBusinessObject</p><p> "<strong>FilterObjectGUID</strong>": Mandatory filter of identifying GUID for required packet</p><p> "<strong>FilterObjectType</strong>": "ID for the type of object being filtered by i.e.</p><p>· Schedule = 260 or</p><p>· Company = 31</p><p> "<strong>SubscriberURL</strong>": "A valid URL (inc. http/https") which can receive the WebHook message</p><p> "<strong>CustomHeader</strong>":  optional field which adds a custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. new-schedule</p><p> "<strong>CustomHeaderValue</strong>": optional field which adds a corresponding value to the custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. New schedule created"</p> |
| **Restrictions**        | User must have Process Builder role                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

{% hint style="info" %}
For **Business Object Created** you only need to supply the FilterObjectType, so you would use:

* FilterObjectType = 31 (Company in the EnateObjects enum)
* WebHook = BusinessObjectCreated

OR

* FilterObjectType = 81 (Schedule in the EnateObjects enum)
* WebHook = BusinessObjectCreated
  {% endhint %}

## BusinessObjectUpdated  <a href="#businessobjectupdated" id="businessobjectupdated"></a>

| Name                    | BusinessObjectUpdated                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Related events**      | Any existing business object of a specified type is updated (Object types **Company** and **Schedule** are provided in this release)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Message returned**    | <p>Returns basic object information in JSON format:<br> {</p><p>"<strong>Name</strong>": name is set by the user, e.g. "2022 Schedule",</p><p>"<strong>GUID</strong>":  the Webhook GUID e.g. "a3bc0b28-8023-4ac2-a0c4-2144e8a2d659"</p><p>}</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Parameters required** | <p>"<strong>Webhook</strong>": Name of the WebHook being subscribed to i.e. BusinessObjectUpdated</p><p>"<strong>FilterObjectGUID</strong>": Should be left empty</p><p>"<strong>FilterObjectType</strong>": "The type of object being filtered by i.e.</p><ul><li>Schedule or</li><li>Company</li></ul><p> "<strong>SubscriberURL</strong>": "A valid URL (inc. http/https") which can receive the WebHook message</p><p>"<strong>CustomHeader</strong>":  optional field which adds a custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. updated-company</p><p>"<strong>CustomHeaderValue</strong>": optional field which adds a corresponding value to the custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. Company details have been updated</p> |
| **Restrictions**        | User must have Process Builder role                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

## SpecificBusinessObjectUpdated  <a href="#businessobjectupdated" id="businessobjectupdated"></a>

| Name                | SpecificBusinessObjectUpdated                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Related events      | A specific business object of a specified type is updated (Object types Company and Schedule are provided in this release)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Message returned    | <p>Returns basic object information in JSON format:<br> { </p><p>"<strong>Name</strong>": name is set by the user, e.g. "2022 Schedule",</p><p>"<strong>GUID</strong>":  the Webhook GUID e.g. "a3bc0b28-8023-4ac2-a0c4-2144e8a2d659" </p><p>}</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Parameters required | <p> "<strong>Webhook</strong>": Name of the WebHook being subscribed to i.e. BusinessObjectUpdated</p><p>"<strong>FilterObjectGUID</strong>": Filter of identifying GUID for required business object</p><p>"<strong>FilterObjectType</strong>": "The type of object being filtered by i.e.</p><ul><li>Schedule or</li><li>Company</li></ul><p> "<strong>SubscriberURL</strong>": "A valid URL (inc. http/https") which can receive the WebHook message </p><p>"<strong>CustomHeader</strong>":  optional field which adds a custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. updated-company</p><p>"<strong>CustomHeaderValue</strong>": optional field which adds a corresponding value to the custom header to all messages sent by the WebHook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process i.e. Company details have been updated</p> |
| Restrictions        | User must have Process Builder role                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enate.net/enate-help/integrations/enate-integrations/webhooks/list-of-enates-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
