Skip to main content
Plan requirement: This feature requires an On-call Standard or higher subscription. Learn more
Use HCP Terraform (formerly Terraform Cloud) workspace notifications to sync Terraform runs to Flashduty On-call. Each run becomes one Flashduty change; every state of a run, from created through planning, waiting for confirmation, and applying to completed, errored, or canceled, updates that same change.

In Flashduty On-call

  1. In the Flashduty console, go to Integration Center → Change Events
  2. Select HCP Terraform and enter an integration name
  3. To assign changes to specific channels, add rules under the integration’s Routes that match labels such as organization or workspace
  4. Click Save and copy the generated Push URL

Configure HCP Terraform

Notifications work per workspace, so configure one for each workspace you want to connect. You need admin permission on the workspace.
1

Open notification settings

In the workspace, go to Settings → Notifications and click Create a notification.
2

Enter the Push URL

  1. Destination: select Webhook
  2. Name: enter a recognizable name, such as Flashduty
  3. Webhook URL: paste the complete Flashduty integration Push URL
  4. Token: leave it empty; Flashduty authenticates with the integration_key in the Push URL
3

Select triggers

  1. Under Run Events, select All events
  2. Under Workspace Events (drift detection, auto destroy, and so on), select No events; Flashduty ignores these notifications
  3. Click Create a notification
When you save, HCP Terraform sends a verification request. Flashduty accepts it without creating a change. You can verify again later with Send a test.
You can also manage this configuration with the Terraform tfe provider: a tfe_notification_configuration resource with destination_type = "generic", url set to the Push URL, and triggers set to ["run:created", "run:planning", "run:needs_attention", "run:applying", "run:completed", "run:errored"].

How changes are merged

Status mapping

Done, Failed, and Canceled are end states; Flashduty records the change’s end time. planned_and_finished means a run that only planned (no changes, or a plan-only run). It is also recorded as Done; use the run_status label to tell it apart. Flashduty accepts these deliveries without creating a change:
  • The verification request sent on save or by Send a test (trigger verification)
  • Health assessment notifications (assessment:drifted, assessment:check_failure, assessment:failed)
  • Workspace notifications (workspace:auto_destroy_reminder, workspace:auto_destroy_run_results, workspace:deleted)

Change content

Use labels for routing and for filtering the change list:

FAQ

  • Make sure the notification is enabled and Run Events are selected. Workspace Events alone create no changes
  • Check recent deliveries and Flashduty’s responses on the notification configuration page
  • Notifications are per workspace; make sure the run’s workspace has this notification configured
No. Flashduty records an event with the same run, status, and time only once.
No. A health assessment reports resources drifting from their configuration, not a change. Flashduty accepts it and ignores it.
  • … is missing or invalid …: the payload is incomplete or a field is malformed. Confirm it comes from an HCP Terraform webhook notification
  • unsupported … or unknown …: Flashduty does not support this trigger or run status yet. Contact us