From b2250d416f4d63adb93d7d5dd7654bbfa2b46a3a Mon Sep 17 00:00:00 2001 From: Lyn Kotuby Date: Tue, 26 Aug 2025 12:08:57 -0400 Subject: [PATCH 1/2] Clarify available events for team notifications Team notifications can only subscribe to change requests, and have never had run progress or other events available as options for subscription. Clarifying the docs here to avoid confusion in the future --- .../users-teams-organizations/teams/notifications.mdx | 4 ++-- .../users-teams-organizations/teams/notifications.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/content/terraform-docs-common/docs/cloud-docs/users-teams-organizations/teams/notifications.mdx b/content/terraform-docs-common/docs/cloud-docs/users-teams-organizations/teams/notifications.mdx index 6742825a9..7219c0eb8 100644 --- a/content/terraform-docs-common/docs/cloud-docs/users-teams-organizations/teams/notifications.mdx +++ b/content/terraform-docs-common/docs/cloud-docs/users-teams-organizations/teams/notifications.mdx @@ -5,7 +5,7 @@ description: Learn how to set up team notifications to notify team members on ex # Manage team notifications -HCP Terraform can use webhooks to notify external systems about run progress, change requests, and other events. Team notifications allow you to configure relevant alerts that notify teams you specify whenever a certain event occurs. +HCP Terraform can use webhooks to notify external systems about events. Team notifications allow you to configure relevant alerts that notify teams you specify whenever a certain event occurs. Team notifications can currently only be configured to send alerts about [change requests](/terraform/cloud-docs/workspaces/change-requests). @include 'tfc-package-callouts/notifications.mdx' @@ -125,4 +125,4 @@ You can use some of the values in the payload to retrieve additional information Slack notifications use Slack's own protocols to verify HCP Terraform's webhook requests. -Generic notifications can include a signature to verify the request. For notification configurations that include a secret token, HCP Terraform's webhook requests include an `X-TFE-Notification-Signature` header containing an HMAC signature computed from the token using the SHA-512 digest algorithm. The notification’s receiving service is responsible for validating the signature. For more information and an example of how to validate the signature, refer to the [API documentation](/terraform/cloud-docs/api-docs/notification-configurations#notification-payload). \ No newline at end of file +Generic notifications can include a signature to verify the request. For notification configurations that include a secret token, HCP Terraform's webhook requests include an `X-TFE-Notification-Signature` header containing an HMAC signature computed from the token using the SHA-512 digest algorithm. The notification’s receiving service is responsible for validating the signature. For more information and an example of how to validate the signature, refer to the [API documentation](/terraform/cloud-docs/api-docs/notification-configurations#notification-payload). diff --git a/content/terraform-enterprise/1.0.x/docs/enterprise/users-teams-organizations/teams/notifications.mdx b/content/terraform-enterprise/1.0.x/docs/enterprise/users-teams-organizations/teams/notifications.mdx index 7eea8eef8..c0def4a5e 100644 --- a/content/terraform-enterprise/1.0.x/docs/enterprise/users-teams-organizations/teams/notifications.mdx +++ b/content/terraform-enterprise/1.0.x/docs/enterprise/users-teams-organizations/teams/notifications.mdx @@ -8,7 +8,7 @@ source: terraform-docs-common # Manage team notifications -HCP Terraform can use webhooks to notify external systems about run progress, change requests, and other events. Team notifications allow you to configure relevant alerts that notify teams you specify whenever a certain event occurs. +HCP Terraform can use webhooks to notify external systems about events. Team notifications allow you to configure relevant alerts that notify teams you specify whenever a certain event occurs. Team notifications can currently only be configured to send alerts about [change requests](/terraform/enterprise/workspaces/change-requests). @include 'tfc-package-callouts/notifications.mdx' From 737d31acc719723255554106d49dce9e48df47a0 Mon Sep 17 00:00:00 2001 From: Lyn Kotuby Date: Fri, 5 Sep 2025 09:55:26 -0400 Subject: [PATCH 2/2] Incorporate PR feedback thanks @rkoron007! --- .../users-teams-organizations/teams/notifications.mdx | 2 +- .../users-teams-organizations/teams/notifications.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/terraform-docs-common/docs/cloud-docs/users-teams-organizations/teams/notifications.mdx b/content/terraform-docs-common/docs/cloud-docs/users-teams-organizations/teams/notifications.mdx index 7219c0eb8..dcdff6d8f 100644 --- a/content/terraform-docs-common/docs/cloud-docs/users-teams-organizations/teams/notifications.mdx +++ b/content/terraform-docs-common/docs/cloud-docs/users-teams-organizations/teams/notifications.mdx @@ -5,7 +5,7 @@ description: Learn how to set up team notifications to notify team members on ex # Manage team notifications -HCP Terraform can use webhooks to notify external systems about events. Team notifications allow you to configure relevant alerts that notify teams you specify whenever a certain event occurs. Team notifications can currently only be configured to send alerts about [change requests](/terraform/cloud-docs/workspaces/change-requests). +HCP Terraform can use webhooks to notify external systems about events. Team notifications allow you to configure relevant alerts that notify teams you specify whenever a certain event occurs. You can only configure team notifications to notify your team of [change requests](/terraform/cloud-docs/workspaces/change-requests). @include 'tfc-package-callouts/notifications.mdx' diff --git a/content/terraform-enterprise/1.0.x/docs/enterprise/users-teams-organizations/teams/notifications.mdx b/content/terraform-enterprise/1.0.x/docs/enterprise/users-teams-organizations/teams/notifications.mdx index c0def4a5e..332839357 100644 --- a/content/terraform-enterprise/1.0.x/docs/enterprise/users-teams-organizations/teams/notifications.mdx +++ b/content/terraform-enterprise/1.0.x/docs/enterprise/users-teams-organizations/teams/notifications.mdx @@ -8,7 +8,7 @@ source: terraform-docs-common # Manage team notifications -HCP Terraform can use webhooks to notify external systems about events. Team notifications allow you to configure relevant alerts that notify teams you specify whenever a certain event occurs. Team notifications can currently only be configured to send alerts about [change requests](/terraform/enterprise/workspaces/change-requests). +HCP Terraform can use webhooks to notify external systems about events. Team notifications allow you to configure relevant alerts that notify teams you specify whenever a certain event occurs. You can only configure team notifications to notify your team of [change requests](/terraform/enterprise/workspaces/change-requests). @include 'tfc-package-callouts/notifications.mdx'