diff --git a/docs/gitbook/how-it-works.md b/docs/gitbook/how-it-works.md
index 48c630e1..5a9bc54c 100644
--- a/docs/gitbook/how-it-works.md
+++ b/docs/gitbook/how-it-works.md
@@ -547,6 +547,8 @@ The canary promotion is paused until the hooks return HTTP 200.
 While the promotion is paused, Flagger will continue to run the metrics checks and rollout hooks.
 * Post-rollout hooks are executed after the canary has been promoted or rolled back. 
 If a post rollout hook fails the error is logged.
+* Event hooks are executed every time Flagger emits a Kubernetes event. When configured,
+every action that Flagger takes during a canary deployment will be sent as JSON via an HTTP POST request.
 
 Spec:
 
@@ -578,6 +580,9 @@ Spec:
         timeout: 5s
         metadata:
           some: "message"
+      - name: "send to Slack"
+        type: event
+        url: http://event-recevier.notifications/slack
 ```
 
 > **Note** that the sum of all rollout webhooks timeouts should be lower than the analysis interval. 
@@ -603,6 +608,24 @@ Response status codes:
 
 On a non-2xx response Flagger will include the response body (if any) in the failed checks log and Kubernetes events.
 
+Event payload (HTTP POST):
+
+```json
+{
+  "name": "string (canary name)",
+  "namespace": "string (canary namespace)",
+  "phase": "string (canary phase)",
+  "metadata": {
+    "eventMessage": "string (canary event message)",
+    "eventType": "string (canary event type)",
+    "timestamp": "string (unix timestamp ms)"
+  }
+}
+```
+
+The event receiver can create alerts based on the received phase
+(possible values: ` Initialized`, `Waiting`, `Progressing`, `Promoting`, `Finalising`, `Succeeded` or `Failed`).
+
 ### Load Testing
 
 For workloads that are not receiving constant traffic Flagger can be configured with a webhook, 
diff --git a/docs/gitbook/usage/alerting.md b/docs/gitbook/usage/alerting.md
index b49dd087..3c462792 100644
--- a/docs/gitbook/usage/alerting.md
+++ b/docs/gitbook/usage/alerting.md
@@ -92,3 +92,13 @@ Example:
   }
 }
 ```
+
+The event webhook can be overwritten at canary level with:
+
+```yaml
+  canaryAnalysis:
+    webhooks:
+      - name: "send to Slack"
+        type: event
+        url: http://event-recevier.notifications/slack
+```