Email and webhook notifications for Timeline release outcomes

Contentful has added email and webhook notifications for scheduled Timeline release outcomes. Release creators and last editors receive emails when a scheduled release fails or completes successfully, helping teams spot release outcomes without adding new failed-release workflows in the Timeline interface.

This update helps teams respond faster when a scheduled release fails, confirm successful scheduled releases, and route release outcome signals into shared operational channels or external systems.

Use email notifications and webhooks to monitor scheduled release outcomes:

  • Release completion emails - Contentful automatically sends an email to the release creator and last editor when a scheduled release fails or completes successfully.
  • Webhook monitoring - Subscribe to the ReleaseAction topic with the execute event to receive a webhook when a release publish succeeds or fails.
  • Release status - Use sys.status in the webhook payload to identify the outcome. A succeeded status means the release was published successfully, and a failed status means the release publish failed.
  • Publish filtering - To monitor publish outcomes only, check that action === "publish" and inspect sys.status for succeeded or failed.

Implementation notes:

  • Email recipients are limited to the release creator and last editor and cannot be configured by users.
  • Success emails do not include a link back to the successful release.
  • Webhook payloads can be used for monitoring and automation, but failure details may be limited.

For more information, refer to the Timeline releases.