# Events

This page lists all event types sent by Abyssale to your configured webhook endpoint.

All events are delivered via an **HTTP POST** request (https only) with the `application/json` content type.

#### Supported Events

The following table details the events you can subscribe to and the specific payload contained within the `data` field for each.

| **Event Name**     | **Trigger Condition**                                                                                                                                                             | **Data Payload Reference**                                                                           |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `NEW_BANNER`       | Triggered when a single banner has been successfully generated or saved.                                                                                                          | [Banner Details Page](https://developers.abyssale.com/webhooks/banner-events#new_banner)             |
| `NEW_EXPORT`       | Triggered when a design export (e.g., a ZIP file of multiple banners) has finished processing and is available for download.                                                      | [Export Details Page](https://developers.abyssale.com/webhooks/global-events#new_export)             |
| `NEW_BANNER_BATCH` | Triggered when an asynchronous batch visual generation API request, which produces multiple banners, has completed. This includes success and error details for the entire batch. | [Banner Batch Details Page](https://developers.abyssale.com/webhooks/banner-events#new_banner_batch) |
| `TEMPLATE_STATUS`  | Triggered when the workflow status on a design is updated (e.g., changed to `APPROVED` ,`REJECTED...`).                                                                           | [Design Status Details Page](https://developers.abyssale.com/webhooks/design-events#template_status) |

***

#### 3. Acknowledging Receipt

To prevent Abyssale from retrying the request, your endpoint must immediately acknowledge successful receipt of the payload.

* *Required Response*: You must return an `HTTP 200 OK` response.
* *Response Body*: The response body can be empty.
* *Timeout*: The response must be returned within the configured timeout period (**max 15 seconds**).