Contentrain Io Webhooks

generated: '2026-11-04'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.contentrain.io/developer/api-reference/webhooks
sources:
- https://docs.contentrain.io/developer/api-reference/webhooks
description: Outbound webhooks notify external services when content events occur; they are project‑scoped and managed via the authenticated Studio
  SPA.
events:
- event: content.saved
  description: Content entry created or updated.
- event: content.deleted
  description: Content entry deleted.
- event: model.saved
  description: Model definition created or updated.
- event: branch.merged
  description: Content branch merged.
- event: branch.rejected
  description: Content branch rejected (deleted).
- event: cdn.build_complete
  description: A CDN build finished.
- event: media.uploaded
  description: A media asset was uploaded.
- event: form.submitted
  description: Form submission received (plans with forms.webhook_notification).
- event: branch.changes_requested
  description: A reviewer requested changes on a content branch.
- event: comment.submitted
  description: A public comment was submitted (plans with comments.webhook_notification).
- event: comment.approved
  description: A comment was approved (plans with comments.webhook_notification).
- event: deploy.triggered
  description: A deploy hook fired; data carries provider, reason, ok, status.
- event: schedule.fired
  description: A scheduled publish_at / expire_at boundary passed; data.boundaries lists the entries.
delivery:
  signature: Webhook requests include an X-Contentrain-Signature header containing the hex HMAC‑SHA256 of the raw request body, keyed with the
    webhook secret (also X-Contentrain-Event header with the event name).
  retries: 'On non‑2xx response or timeout, deliveries are retried with exponential backoff: 1 minute, 5 minutes, 30 minutes, 2 hours, then 12 hours
    (maximum 5 retries). After the final retry the delivery is marked failed and admins receive an alert email.'
docs: https://docs.contentrain.io/developer/api-reference/webhooks