Skip to content

[TF-28096] Clarify events that team notifications can subscribe to #866

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Sep 5, 2025
Merged

[TF-28096] Clarify events that team notifications can subscribe to #866

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b2250d4
Clarify available events for team notifications
nylkotuby Aug 26, 2025
737d31a
Incorporate PR feedback
nylkotuby Sep 5, 2025
ba9d2c6
Merge branch 'main' into nylkotuby/update-team-notis
nylkotuby Sep 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions ...m-docs-common/docs/cloud-docs/users-teams-organizations/teams/notifications.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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. 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'

Expand Down Expand Up @@ -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).
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).
Copy link
Contributor Author

@nylkotuby nylkotuby Aug 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No actual diff on this line, CRLF

2 changes: 1 addition & 1 deletion ...erprise/1.0.x/docs/enterprise/users-teams-organizations/teams/notifications.mdx
View file
Open in desktop
Copy link
Contributor Author

@nylkotuby nylkotuby Aug 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wasn't sure how to address enterprise in this change, lmk if this is appropriate

Original file line number Diff line number Diff line change
Expand Up @@ -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. You can only configure team notifications to notify your team of [change requests](/terraform/enterprise/workspaces/change-requests).

@include 'tfc-package-callouts/notifications.mdx'

Expand Down
Loading