diff --git a/apify-api/openapi/components/schemas/webhooks/WebhookRepresentation.yaml b/apify-api/openapi/components/schemas/webhooks/WebhookRepresentation.yaml
index d0a7c90c07..70ae89bacd 100644
--- a/apify-api/openapi/components/schemas/webhooks/WebhookRepresentation.yaml
+++ b/apify-api/openapi/components/schemas/webhooks/WebhookRepresentation.yaml
@@ -26,3 +26,15 @@ properties:
     type: [string, "null"]
     description: Optional template for the HTTP headers sent by the webhook.
     examples: ['{\n "Authorization": "Bearer ..."}']
+  idempotencyKey:
+    type: [string, "null"]
+    description: Optional key that prevents creating duplicate webhooks, e.g. when the run-starting request is retried.
+    examples: [fdSJmdP3nfs7sfk3y]
+  ignoreSslErrors:
+    type: [boolean, "null"]
+    description: Optional flag to ignore SSL errors when the webhook sends the request.
+    examples: [false]
+  doNotRetry:
+    type: [boolean, "null"]
+    description: Optional flag to skip retrying the webhook request on failure.
+    examples: [false]