1. Registry
  2. Packages
  3. Pulumi Cloud (Pulumi Service provider)
  4. API Docs
  5. Webhook
Viewing docs for Pulumi Cloud v1.8.0
published on Thursday, Nov 19, 2026 by Pulumi
pulumiservice logo pulumiservice logo
Viewing docs for Pulumi Cloud v1.8.0
published on Thursday, Nov 19, 2026 by Pulumi

    Pulumi Webhooks allow you to notify external services of events happening within your Pulumi organization, stack, or ESC environment. For example, you can trigger a notification whenever a stack is updated or an environment revision is created. Whenever an event occurs, Pulumi will send an HTTP POST request to all registered webhooks. The webhook can then be used to emit some notification, start running integration tests, or even update additional stacks.

    The webhook’s scope is set by which properties you provide:

    • Organization webhook: organizationName only.
    • Stack webhook: organizationName, projectName, and stackName.
    • Environment webhook: organizationName, projectName, and environmentName. See ESC webhooks for the available events.

    Create Webhook Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Webhook(name: string, args: WebhookArgs, opts?: CustomResourceOptions);
    @overload
    def Webhook(resource_name: str,
                args: WebhookArgs,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def Webhook(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                active: Optional[bool] = None,
                organization_name: Optional[str] = None,
                payload_url: Optional[str] = None,
                display_name: Optional[str] = None,
                environment_name: Optional[str] = None,
                filters: Optional[Sequence[WebhookFilters]] = None,
                format: Optional[WebhookFormat] = None,
                groups: Optional[Sequence[WebhookGroup]] = None,
                project_name: Optional[str] = None,
                secret: Optional[str] = None,
                stack_name: Optional[str] = None)
    func NewWebhook(ctx *Context, name string, args WebhookArgs, opts ...ResourceOption) (*Webhook, error)
    public Webhook(string name, WebhookArgs args, CustomResourceOptions? opts = null)
    public Webhook(String name, WebhookArgs args)
    public Webhook(String name, WebhookArgs args, CustomResourceOptions options)
    
    type: pulumiservice:Webhook
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "pulumiservice_webhook" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args WebhookArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args WebhookArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args WebhookArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args WebhookArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args WebhookArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var examplewebhookResourceResourceFromIndex = new PulumiService.Webhook("examplewebhookResourceResourceFromIndex", new()
    {
        Active = false,
        OrganizationName = "string",
        PayloadUrl = "string",
        DisplayName = "string",
        EnvironmentName = "string",
        Filters = new[]
        {
            PulumiService.WebhookFilters.StackCreated,
        },
        Format = PulumiService.WebhookFormat.Raw,
        Groups = new[]
        {
            PulumiService.WebhookGroup.Stacks,
        },
        ProjectName = "string",
        Secret = "string",
        StackName = "string",
    });
    
    example, err := pulumiservice.NewWebhook(ctx, "examplewebhookResourceResourceFromIndex", &pulumiservice.WebhookArgs{
    	Active:           pulumi.Bool(false),
    	OrganizationName: pulumi.String("string"),
    	PayloadUrl:       pulumi.String("string"),
    	DisplayName:      pulumi.String("string"),
    	EnvironmentName:  pulumi.String("string"),
    	Filters: pulumiservice.WebhookFiltersArray{
    		pulumiservice.WebhookFiltersStackCreated,
    	},
    	Format: pulumiservice.WebhookFormatRaw,
    	Groups: pulumiservice.WebhookGroupArray{
    		pulumiservice.WebhookGroupStacks,
    	},
    	ProjectName: pulumi.String("string"),
    	Secret:      pulumi.String("string"),
    	StackName:   pulumi.String("string"),
    })
    
    resource "pulumiservice_webhook" "examplewebhookResourceResourceFromIndex" {
      lifecycle {
        create_before_destroy = true
      }
      active            = false
      organization_name = "string"
      payload_url       = "string"
      display_name      = "string"
      environment_name  = "string"
      filters           = ["stack_created"]
      format            = "raw"
      groups            = ["stacks"]
      project_name      = "string"
      secret            = "string"
      stack_name        = "string"
    }
    
    var examplewebhookResourceResourceFromIndex = new com.pulumi.pulumiservice.Webhook("examplewebhookResourceResourceFromIndex", com.pulumi.pulumiservice.WebhookArgs.builder()
        .active(false)
        .organizationName("string")
        .payloadUrl("string")
        .displayName("string")
        .environmentName("string")
        .filters("stack_created")
        .format(com.pulumi.pulumiservice.enums.WebhookFormat.Raw)
        .groups("stacks")
        .projectName("string")
        .secret("string")
        .stackName("string")
        .build());
    
    examplewebhook_resource_resource_from_index = pulumiservice.Webhook("examplewebhookResourceResourceFromIndex",
        active=False,
        organization_name="string",
        payload_url="string",
        display_name="string",
        environment_name="string",
        filters=[pulumiservice.WebhookFilters.STACK_CREATED],
        format=pulumiservice.WebhookFormat.RAW,
        groups=[pulumiservice.WebhookGroup.STACKS],
        project_name="string",
        secret="string",
        stack_name="string")
    
    const examplewebhookResourceResourceFromIndex = new pulumiservice.Webhook("examplewebhookResourceResourceFromIndex", {
        active: false,
        organizationName: "string",
        payloadUrl: "string",
        displayName: "string",
        environmentName: "string",
        filters: [pulumiservice.WebhookFilters.StackCreated],
        format: pulumiservice.WebhookFormat.Raw,
        groups: [pulumiservice.WebhookGroup.Stacks],
        projectName: "string",
        secret: "string",
        stackName: "string",
    });
    
    type: pulumiservice:Webhook
    properties:
        active: false
        displayName: string
        environmentName: string
        filters:
            - stack_created
        format: raw
        groups:
            - stacks
        organizationName: string
        payloadUrl: string
        projectName: string
        secret: string
        stackName: string
    

    Webhook Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Webhook resource accepts the following input properties:

    Active bool
    Indicates whether this webhook is enabled or not.
    OrganizationName string
    Name of the organization.
    PayloadUrl string
    URL to send request to.
    DisplayName string
    The friendly name displayed in the Pulumi Cloud, up to 100 bytes. If omitted, Pulumi generates a name from the resource's logical name plus a random suffix, or follows the stack's autonaming configuration.
    EnvironmentName string
    Name of the environment. Only specified if this is an environment webhook.
    Filters List<Pulumi.PulumiService.WebhookFilters>
    Optional set of filters to apply to the webhook. See webhook docs for more information.
    Format Pulumi.PulumiService.WebhookFormat
    Format of the webhook payload. Can be either raw, slack, ms_teams or pulumi_deployments. Defaults to raw.
    Groups List<Pulumi.PulumiService.WebhookGroup>
    Optional set of filter groups to apply to the webhook. See webhook docs for more information.
    ProjectName string
    Name of the project. Only specified if this is a stack or environment webhook.
    Secret string
    Optional. secret used as the HMAC key. See webhook docs for more information.
    StackName string
    Name of the stack. Only needed if this is a stack webhook.
    Active bool
    Indicates whether this webhook is enabled or not.
    OrganizationName string
    Name of the organization.
    PayloadUrl string
    URL to send request to.
    DisplayName string
    The friendly name displayed in the Pulumi Cloud, up to 100 bytes. If omitted, Pulumi generates a name from the resource's logical name plus a random suffix, or follows the stack's autonaming configuration.
    EnvironmentName string
    Name of the environment. Only specified if this is an environment webhook.
    Filters []WebhookFilters
    Optional set of filters to apply to the webhook. See webhook docs for more information.
    Format WebhookFormat
    Format of the webhook payload. Can be either raw, slack, ms_teams or pulumi_deployments. Defaults to raw.
    Groups []WebhookGroup
    Optional set of filter groups to apply to the webhook. See webhook docs for more information.
    ProjectName string
    Name of the project. Only specified if this is a stack or environment webhook.
    Secret string
    Optional. secret used as the HMAC key. See webhook docs for more information.
    StackName string
    Name of the stack. Only needed if this is a stack webhook.
    active bool
    Indicates whether this webhook is enabled or not.
    organization_name string
    Name of the organization.
    payload_url string
    URL to send request to.
    display_name string
    The friendly name displayed in the Pulumi Cloud, up to 100 bytes. If omitted, Pulumi generates a name from the resource's logical name plus a random suffix, or follows the stack's autonaming configuration.
    environment_name string
    Name of the environment. Only specified if this is an environment webhook.
    filters list("stack_created" | "stack_deleted" | "update_succeeded" | "update_failed" | "preview_succeeded" | "preview_failed" | "destroy_succeeded" | "destroy_failed" | "refresh_succeeded" | "refresh_failed" | "deployment_queued" | "deployment_started" | "deployment_succeeded" | "deployment_failed" | "drift_detected" | "drift_detection_succeeded" | "drift_detection_failed" | "drift_remediation_succeeded" | "drift_remediation_failed" | "environment_created" | "environment_deleted" | "environment_revision_created" | "environment_revision_retracted" | "environment_revision_tag_created" | "environment_revision_tag_deleted" | "environment_revision_tag_updated" | "environment_tag_created" | "environment_tag_deleted" | "environment_tag_updated" | "imported_environment_changed" | "environment_rotation_succeeded" | "environment_rotation_failed")
    Optional set of filters to apply to the webhook. See webhook docs for more information.
    format "raw" | "slack" | "pulumi_deployments" | "ms_teams"
    Format of the webhook payload. Can be either raw, slack, ms_teams or pulumi_deployments. Defaults to raw.
    groups list("stacks" | "deployments" | "environments")
    Optional set of filter groups to apply to the webhook. See webhook docs for more information.
    project_name string
    Name of the project. Only specified if this is a stack or environment webhook.
    secret string
    Optional. secret used as the HMAC key. See webhook docs for more information.
    stack_name string
    Name of the stack. Only needed if this is a stack webhook.
    active Boolean
    Indicates whether this webhook is enabled or not.
    organizationName String
    Name of the organization.
    payloadUrl String
    URL to send request to.
    displayName String
    The friendly name displayed in the Pulumi Cloud, up to 100 bytes. If omitted, Pulumi generates a name from the resource's logical name plus a random suffix, or follows the stack's autonaming configuration.
    environmentName String
    Name of the environment. Only specified if this is an environment webhook.
    filters List<WebhookFilters>
    Optional set of filters to apply to the webhook. See webhook docs for more information.
    format WebhookFormat
    Format of the webhook payload. Can be either raw, slack, ms_teams or pulumi_deployments. Defaults to raw.
    groups List<WebhookGroup>
    Optional set of filter groups to apply to the webhook. See webhook docs for more information.
    projectName String
    Name of the project. Only specified if this is a stack or environment webhook.
    secret String
    Optional. secret used as the HMAC key. See webhook docs for more information.
    stackName String
    Name of the stack. Only needed if this is a stack webhook.
    active boolean
    Indicates whether this webhook is enabled or not.
    organizationName string
    Name of the organization.
    payloadUrl string
    URL to send request to.
    displayName string
    The friendly name displayed in the Pulumi Cloud, up to 100 bytes. If omitted, Pulumi generates a name from the resource's logical name plus a random suffix, or follows the stack's autonaming configuration.
    environmentName string
    Name of the environment. Only specified if this is an environment webhook.
    filters WebhookFilters[]
    Optional set of filters to apply to the webhook. See webhook docs for more information.
    format WebhookFormat
    Format of the webhook payload. Can be either raw, slack, ms_teams or pulumi_deployments. Defaults to raw.
    groups WebhookGroup[]
    Optional set of filter groups to apply to the webhook. See webhook docs for more information.
    projectName string
    Name of the project. Only specified if this is a stack or environment webhook.
    secret string
    Optional. secret used as the HMAC key. See webhook docs for more information.
    stackName string
    Name of the stack. Only needed if this is a stack webhook.
    active bool
    Indicates whether this webhook is enabled or not.
    organization_name str
    Name of the organization.
    payload_url str
    URL to send request to.
    display_name str
    The friendly name displayed in the Pulumi Cloud, up to 100 bytes. If omitted, Pulumi generates a name from the resource's logical name plus a random suffix, or follows the stack's autonaming configuration.
    environment_name str
    Name of the environment. Only specified if this is an environment webhook.
    filters Sequence[WebhookFilters]
    Optional set of filters to apply to the webhook. See webhook docs for more information.
    format WebhookFormat
    Format of the webhook payload. Can be either raw, slack, ms_teams or pulumi_deployments. Defaults to raw.
    groups Sequence[WebhookGroup]
    Optional set of filter groups to apply to the webhook. See webhook docs for more information.
    project_name str
    Name of the project. Only specified if this is a stack or environment webhook.
    secret str
    Optional. secret used as the HMAC key. See webhook docs for more information.
    stack_name str
    Name of the stack. Only needed if this is a stack webhook.
    active Boolean
    Indicates whether this webhook is enabled or not.
    organizationName String
    Name of the organization.
    payloadUrl String
    URL to send request to.
    displayName String
    The friendly name displayed in the Pulumi Cloud, up to 100 bytes. If omitted, Pulumi generates a name from the resource's logical name plus a random suffix, or follows the stack's autonaming configuration.
    environmentName String
    Name of the environment. Only specified if this is an environment webhook.
    filters List<"stack_created" | "stack_deleted" | "update_succeeded" | "update_failed" | "preview_succeeded" | "preview_failed" | "destroy_succeeded" | "destroy_failed" | "refresh_succeeded" | "refresh_failed" | "deployment_queued" | "deployment_started" | "deployment_succeeded" | "deployment_failed" | "drift_detected" | "drift_detection_succeeded" | "drift_detection_failed" | "drift_remediation_succeeded" | "drift_remediation_failed" | "environment_created" | "environment_deleted" | "environment_revision_created" | "environment_revision_retracted" | "environment_revision_tag_created" | "environment_revision_tag_deleted" | "environment_revision_tag_updated" | "environment_tag_created" | "environment_tag_deleted" | "environment_tag_updated" | "imported_environment_changed" | "environment_rotation_succeeded" | "environment_rotation_failed">
    Optional set of filters to apply to the webhook. See webhook docs for more information.
    format "raw" | "slack" | "pulumi_deployments" | "ms_teams"
    Format of the webhook payload. Can be either raw, slack, ms_teams or pulumi_deployments. Defaults to raw.
    groups List<"stacks" | "deployments" | "environments">
    Optional set of filter groups to apply to the webhook. See webhook docs for more information.
    projectName String
    Name of the project. Only specified if this is a stack or environment webhook.
    secret String
    Optional. secret used as the HMAC key. See webhook docs for more information.
    stackName String
    Name of the stack. Only needed if this is a stack webhook.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Webhook resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Webhook identifier generated by Pulumi Cloud.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Webhook identifier generated by Pulumi Cloud.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    Webhook identifier generated by Pulumi Cloud.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Webhook identifier generated by Pulumi Cloud.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    Webhook identifier generated by Pulumi Cloud.
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    Webhook identifier generated by Pulumi Cloud.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Webhook identifier generated by Pulumi Cloud.

    Look up Existing Webhook Resource

    Get an existing Webhook resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, opts?: CustomResourceOptions): Webhook
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None) -> Webhook
    func GetWebhook(ctx *Context, name string, id IDInput, state *WebhookState, opts ...ResourceOption) (*Webhook, error)
    public static Webhook Get(string name, Input<string> id, CustomResourceOptions? opts = null)
    public static Webhook get(String name, Output<String> id, CustomResourceOptions options)
    resources:  existingWebhook:    type: pulumiservice:Webhook    get:      id: ${id}
    import {
      to = pulumiservice_webhook.example
      id = "${id}"
    }
    
    name string
    The unique name of the resulting resource.
    id Input<ID>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resulting resource.
    id str
    The unique provider ID of the resource to look up.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resulting resource.
    id IDInput
    The unique provider ID of the resource to look up.
    state WebhookState
    Pass nil. This resource has no state arguments.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resulting resource.
    id Input<string>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resulting resource.
    id Output<String>
    The unique provider ID of the resource to look up.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Supporting Types

    WebhookFilters

    NameValueDescription
    StackCreatedstack_createdTrigger a webhook when a stack is created. Only valid for org webhooks.
    StackDeletedstack_deletedTrigger a webhook when a stack is deleted. Only valid for org webhooks.
    UpdateSucceededupdate_succeededTrigger a webhook when a stack update succeeds.
    UpdateFailedupdate_failedTrigger a webhook when a stack update fails.
    PreviewSucceededpreview_succeededTrigger a webhook when a stack preview succeeds.
    PreviewFailedpreview_failedTrigger a webhook when a stack preview fails.
    DestroySucceededdestroy_succeededTrigger a webhook when a stack destroy succeeds.
    DestroyFaileddestroy_failedTrigger a webhook when a stack destroy fails.
    RefreshSucceededrefresh_succeededTrigger a webhook when a stack refresh succeeds.
    RefreshFailedrefresh_failedTrigger a webhook when a stack refresh fails.
    DeploymentQueueddeployment_queuedTrigger a webhook when a deployment is queued.
    DeploymentStarteddeployment_startedTrigger a webhook when a deployment starts running.
    DeploymentSucceededdeployment_succeededTrigger a webhook when a deployment succeeds.
    DeploymentFaileddeployment_failedTrigger a webhook when a deployment fails.
    DriftDetecteddrift_detectedTrigger a webhook when drift is detected.
    DriftDetectionSucceededdrift_detection_succeededTrigger a webhook when a drift detection run succeeds, regardless of whether drift is detected.
    DriftDetectionFaileddrift_detection_failedTrigger a webhook when a drift detection run fails.
    DriftRemediationSucceededdrift_remediation_succeededTrigger a webhook when a drift remediation run succeeds.
    DriftRemediationFaileddrift_remediation_failedTrigger a webhook when a drift remediation run fails.
    EnvironmentCreatedenvironment_createdTrigger a webhook when a new environment is created.
    EnvironmentDeletedenvironment_deletedTrigger a webhook when an environment is deleted.
    EnvironmentRevisionCreatedenvironment_revision_createdTrigger a webhook when a new revision is created on an environment.
    EnvironmentRevisionRetractedenvironment_revision_retractedTrigger a webhook when a revision is retracted on an environment.
    EnvironmentRevisionTagCreatedenvironment_revision_tag_createdTrigger a webhook when a revision tag is created on an environment.
    EnvironmentRevisionTagDeletedenvironment_revision_tag_deletedTrigger a webhook when a revision tag is deleted on an environment.
    EnvironmentRevisionTagUpdatedenvironment_revision_tag_updatedTrigger a webhook when a revision tag is updated on an environment.
    EnvironmentTagCreatedenvironment_tag_createdTrigger a webhook when an environment tag is created.
    EnvironmentTagDeletedenvironment_tag_deletedTrigger a webhook when an environment tag is deleted.
    EnvironmentTagUpdatedenvironment_tag_updatedTrigger a webhook when an environment tag is updated.
    ImportedEnvironmentChangedimported_environment_changedTrigger a webhook when an imported environment has changed.
    EnvironmentRotationSucceededenvironment_rotation_succeededTrigger a webhook when an environment rotation succeeds.
    EnvironmentRotationFailedenvironment_rotation_failedTrigger a webhook when an environment rotation fails.
    NameValueDescription
    WebhookFiltersStackCreatedstack_createdTrigger a webhook when a stack is created. Only valid for org webhooks.
    WebhookFiltersStackDeletedstack_deletedTrigger a webhook when a stack is deleted. Only valid for org webhooks.
    WebhookFiltersUpdateSucceededupdate_succeededTrigger a webhook when a stack update succeeds.
    WebhookFiltersUpdateFailedupdate_failedTrigger a webhook when a stack update fails.
    WebhookFiltersPreviewSucceededpreview_succeededTrigger a webhook when a stack preview succeeds.
    WebhookFiltersPreviewFailedpreview_failedTrigger a webhook when a stack preview fails.
    WebhookFiltersDestroySucceededdestroy_succeededTrigger a webhook when a stack destroy succeeds.
    WebhookFiltersDestroyFaileddestroy_failedTrigger a webhook when a stack destroy fails.
    WebhookFiltersRefreshSucceededrefresh_succeededTrigger a webhook when a stack refresh succeeds.
    WebhookFiltersRefreshFailedrefresh_failedTrigger a webhook when a stack refresh fails.
    WebhookFiltersDeploymentQueueddeployment_queuedTrigger a webhook when a deployment is queued.
    WebhookFiltersDeploymentStarteddeployment_startedTrigger a webhook when a deployment starts running.
    WebhookFiltersDeploymentSucceededdeployment_succeededTrigger a webhook when a deployment succeeds.
    WebhookFiltersDeploymentFaileddeployment_failedTrigger a webhook when a deployment fails.
    WebhookFiltersDriftDetecteddrift_detectedTrigger a webhook when drift is detected.
    WebhookFiltersDriftDetectionSucceededdrift_detection_succeededTrigger a webhook when a drift detection run succeeds, regardless of whether drift is detected.
    WebhookFiltersDriftDetectionFaileddrift_detection_failedTrigger a webhook when a drift detection run fails.
    WebhookFiltersDriftRemediationSucceededdrift_remediation_succeededTrigger a webhook when a drift remediation run succeeds.
    WebhookFiltersDriftRemediationFaileddrift_remediation_failedTrigger a webhook when a drift remediation run fails.
    WebhookFiltersEnvironmentCreatedenvironment_createdTrigger a webhook when a new environment is created.
    WebhookFiltersEnvironmentDeletedenvironment_deletedTrigger a webhook when an environment is deleted.
    WebhookFiltersEnvironmentRevisionCreatedenvironment_revision_createdTrigger a webhook when a new revision is created on an environment.
    WebhookFiltersEnvironmentRevisionRetractedenvironment_revision_retractedTrigger a webhook when a revision is retracted on an environment.
    WebhookFiltersEnvironmentRevisionTagCreatedenvironment_revision_tag_createdTrigger a webhook when a revision tag is created on an environment.
    WebhookFiltersEnvironmentRevisionTagDeletedenvironment_revision_tag_deletedTrigger a webhook when a revision tag is deleted on an environment.
    WebhookFiltersEnvironmentRevisionTagUpdatedenvironment_revision_tag_updatedTrigger a webhook when a revision tag is updated on an environment.
    WebhookFiltersEnvironmentTagCreatedenvironment_tag_createdTrigger a webhook when an environment tag is created.
    WebhookFiltersEnvironmentTagDeletedenvironment_tag_deletedTrigger a webhook when an environment tag is deleted.
    WebhookFiltersEnvironmentTagUpdatedenvironment_tag_updatedTrigger a webhook when an environment tag is updated.
    WebhookFiltersImportedEnvironmentChangedimported_environment_changedTrigger a webhook when an imported environment has changed.
    WebhookFiltersEnvironmentRotationSucceededenvironment_rotation_succeededTrigger a webhook when an environment rotation succeeds.
    WebhookFiltersEnvironmentRotationFailedenvironment_rotation_failedTrigger a webhook when an environment rotation fails.
    ValueDescription
    stack_createdTrigger a webhook when a stack is created. Only valid for org webhooks.
    stack_deletedTrigger a webhook when a stack is deleted. Only valid for org webhooks.
    update_succeededTrigger a webhook when a stack update succeeds.
    update_failedTrigger a webhook when a stack update fails.
    preview_succeededTrigger a webhook when a stack preview succeeds.
    preview_failedTrigger a webhook when a stack preview fails.
    destroy_succeededTrigger a webhook when a stack destroy succeeds.
    destroy_failedTrigger a webhook when a stack destroy fails.
    refresh_succeededTrigger a webhook when a stack refresh succeeds.
    refresh_failedTrigger a webhook when a stack refresh fails.
    deployment_queuedTrigger a webhook when a deployment is queued.
    deployment_startedTrigger a webhook when a deployment starts running.
    deployment_succeededTrigger a webhook when a deployment succeeds.
    deployment_failedTrigger a webhook when a deployment fails.
    drift_detectedTrigger a webhook when drift is detected.
    drift_detection_succeededTrigger a webhook when a drift detection run succeeds, regardless of whether drift is detected.
    drift_detection_failedTrigger a webhook when a drift detection run fails.
    drift_remediation_succeededTrigger a webhook when a drift remediation run succeeds.
    drift_remediation_failedTrigger a webhook when a drift remediation run fails.
    environment_createdTrigger a webhook when a new environment is created.
    environment_deletedTrigger a webhook when an environment is deleted.
    environment_revision_createdTrigger a webhook when a new revision is created on an environment.
    environment_revision_retractedTrigger a webhook when a revision is retracted on an environment.
    environment_revision_tag_createdTrigger a webhook when a revision tag is created on an environment.
    environment_revision_tag_deletedTrigger a webhook when a revision tag is deleted on an environment.
    environment_revision_tag_updatedTrigger a webhook when a revision tag is updated on an environment.
    environment_tag_createdTrigger a webhook when an environment tag is created.
    environment_tag_deletedTrigger a webhook when an environment tag is deleted.
    environment_tag_updatedTrigger a webhook when an environment tag is updated.
    imported_environment_changedTrigger a webhook when an imported environment has changed.
    environment_rotation_succeededTrigger a webhook when an environment rotation succeeds.
    environment_rotation_failedTrigger a webhook when an environment rotation fails.
    NameValueDescription
    StackCreatedstack_createdTrigger a webhook when a stack is created. Only valid for org webhooks.
    StackDeletedstack_deletedTrigger a webhook when a stack is deleted. Only valid for org webhooks.
    UpdateSucceededupdate_succeededTrigger a webhook when a stack update succeeds.
    UpdateFailedupdate_failedTrigger a webhook when a stack update fails.
    PreviewSucceededpreview_succeededTrigger a webhook when a stack preview succeeds.
    PreviewFailedpreview_failedTrigger a webhook when a stack preview fails.
    DestroySucceededdestroy_succeededTrigger a webhook when a stack destroy succeeds.
    DestroyFaileddestroy_failedTrigger a webhook when a stack destroy fails.
    RefreshSucceededrefresh_succeededTrigger a webhook when a stack refresh succeeds.
    RefreshFailedrefresh_failedTrigger a webhook when a stack refresh fails.
    DeploymentQueueddeployment_queuedTrigger a webhook when a deployment is queued.
    DeploymentStarteddeployment_startedTrigger a webhook when a deployment starts running.
    DeploymentSucceededdeployment_succeededTrigger a webhook when a deployment succeeds.
    DeploymentFaileddeployment_failedTrigger a webhook when a deployment fails.
    DriftDetecteddrift_detectedTrigger a webhook when drift is detected.
    DriftDetectionSucceededdrift_detection_succeededTrigger a webhook when a drift detection run succeeds, regardless of whether drift is detected.
    DriftDetectionFaileddrift_detection_failedTrigger a webhook when a drift detection run fails.
    DriftRemediationSucceededdrift_remediation_succeededTrigger a webhook when a drift remediation run succeeds.
    DriftRemediationFaileddrift_remediation_failedTrigger a webhook when a drift remediation run fails.
    EnvironmentCreatedenvironment_createdTrigger a webhook when a new environment is created.
    EnvironmentDeletedenvironment_deletedTrigger a webhook when an environment is deleted.
    EnvironmentRevisionCreatedenvironment_revision_createdTrigger a webhook when a new revision is created on an environment.
    EnvironmentRevisionRetractedenvironment_revision_retractedTrigger a webhook when a revision is retracted on an environment.
    EnvironmentRevisionTagCreatedenvironment_revision_tag_createdTrigger a webhook when a revision tag is created on an environment.
    EnvironmentRevisionTagDeletedenvironment_revision_tag_deletedTrigger a webhook when a revision tag is deleted on an environment.
    EnvironmentRevisionTagUpdatedenvironment_revision_tag_updatedTrigger a webhook when a revision tag is updated on an environment.
    EnvironmentTagCreatedenvironment_tag_createdTrigger a webhook when an environment tag is created.
    EnvironmentTagDeletedenvironment_tag_deletedTrigger a webhook when an environment tag is deleted.
    EnvironmentTagUpdatedenvironment_tag_updatedTrigger a webhook when an environment tag is updated.
    ImportedEnvironmentChangedimported_environment_changedTrigger a webhook when an imported environment has changed.
    EnvironmentRotationSucceededenvironment_rotation_succeededTrigger a webhook when an environment rotation succeeds.
    EnvironmentRotationFailedenvironment_rotation_failedTrigger a webhook when an environment rotation fails.
    NameValueDescription
    StackCreatedstack_createdTrigger a webhook when a stack is created. Only valid for org webhooks.
    StackDeletedstack_deletedTrigger a webhook when a stack is deleted. Only valid for org webhooks.
    UpdateSucceededupdate_succeededTrigger a webhook when a stack update succeeds.
    UpdateFailedupdate_failedTrigger a webhook when a stack update fails.
    PreviewSucceededpreview_succeededTrigger a webhook when a stack preview succeeds.
    PreviewFailedpreview_failedTrigger a webhook when a stack preview fails.
    DestroySucceededdestroy_succeededTrigger a webhook when a stack destroy succeeds.
    DestroyFaileddestroy_failedTrigger a webhook when a stack destroy fails.
    RefreshSucceededrefresh_succeededTrigger a webhook when a stack refresh succeeds.
    RefreshFailedrefresh_failedTrigger a webhook when a stack refresh fails.
    DeploymentQueueddeployment_queuedTrigger a webhook when a deployment is queued.
    DeploymentStarteddeployment_startedTrigger a webhook when a deployment starts running.
    DeploymentSucceededdeployment_succeededTrigger a webhook when a deployment succeeds.
    DeploymentFaileddeployment_failedTrigger a webhook when a deployment fails.
    DriftDetecteddrift_detectedTrigger a webhook when drift is detected.
    DriftDetectionSucceededdrift_detection_succeededTrigger a webhook when a drift detection run succeeds, regardless of whether drift is detected.
    DriftDetectionFaileddrift_detection_failedTrigger a webhook when a drift detection run fails.
    DriftRemediationSucceededdrift_remediation_succeededTrigger a webhook when a drift remediation run succeeds.
    DriftRemediationFaileddrift_remediation_failedTrigger a webhook when a drift remediation run fails.
    EnvironmentCreatedenvironment_createdTrigger a webhook when a new environment is created.
    EnvironmentDeletedenvironment_deletedTrigger a webhook when an environment is deleted.
    EnvironmentRevisionCreatedenvironment_revision_createdTrigger a webhook when a new revision is created on an environment.
    EnvironmentRevisionRetractedenvironment_revision_retractedTrigger a webhook when a revision is retracted on an environment.
    EnvironmentRevisionTagCreatedenvironment_revision_tag_createdTrigger a webhook when a revision tag is created on an environment.
    EnvironmentRevisionTagDeletedenvironment_revision_tag_deletedTrigger a webhook when a revision tag is deleted on an environment.
    EnvironmentRevisionTagUpdatedenvironment_revision_tag_updatedTrigger a webhook when a revision tag is updated on an environment.
    EnvironmentTagCreatedenvironment_tag_createdTrigger a webhook when an environment tag is created.
    EnvironmentTagDeletedenvironment_tag_deletedTrigger a webhook when an environment tag is deleted.
    EnvironmentTagUpdatedenvironment_tag_updatedTrigger a webhook when an environment tag is updated.
    ImportedEnvironmentChangedimported_environment_changedTrigger a webhook when an imported environment has changed.
    EnvironmentRotationSucceededenvironment_rotation_succeededTrigger a webhook when an environment rotation succeeds.
    EnvironmentRotationFailedenvironment_rotation_failedTrigger a webhook when an environment rotation fails.
    NameValueDescription
    STACK_CREATEDstack_createdTrigger a webhook when a stack is created. Only valid for org webhooks.
    STACK_DELETEDstack_deletedTrigger a webhook when a stack is deleted. Only valid for org webhooks.
    UPDATE_SUCCEEDEDupdate_succeededTrigger a webhook when a stack update succeeds.
    UPDATE_FAILEDupdate_failedTrigger a webhook when a stack update fails.
    PREVIEW_SUCCEEDEDpreview_succeededTrigger a webhook when a stack preview succeeds.
    PREVIEW_FAILEDpreview_failedTrigger a webhook when a stack preview fails.
    DESTROY_SUCCEEDEDdestroy_succeededTrigger a webhook when a stack destroy succeeds.
    DESTROY_FAILEDdestroy_failedTrigger a webhook when a stack destroy fails.
    REFRESH_SUCCEEDEDrefresh_succeededTrigger a webhook when a stack refresh succeeds.
    REFRESH_FAILEDrefresh_failedTrigger a webhook when a stack refresh fails.
    DEPLOYMENT_QUEUEDdeployment_queuedTrigger a webhook when a deployment is queued.
    DEPLOYMENT_STARTEDdeployment_startedTrigger a webhook when a deployment starts running.
    DEPLOYMENT_SUCCEEDEDdeployment_succeededTrigger a webhook when a deployment succeeds.
    DEPLOYMENT_FAILEDdeployment_failedTrigger a webhook when a deployment fails.
    DRIFT_DETECTEDdrift_detectedTrigger a webhook when drift is detected.
    DRIFT_DETECTION_SUCCEEDEDdrift_detection_succeededTrigger a webhook when a drift detection run succeeds, regardless of whether drift is detected.
    DRIFT_DETECTION_FAILEDdrift_detection_failedTrigger a webhook when a drift detection run fails.
    DRIFT_REMEDIATION_SUCCEEDEDdrift_remediation_succeededTrigger a webhook when a drift remediation run succeeds.
    DRIFT_REMEDIATION_FAILEDdrift_remediation_failedTrigger a webhook when a drift remediation run fails.
    ENVIRONMENT_CREATEDenvironment_createdTrigger a webhook when a new environment is created.
    ENVIRONMENT_DELETEDenvironment_deletedTrigger a webhook when an environment is deleted.
    ENVIRONMENT_REVISION_CREATEDenvironment_revision_createdTrigger a webhook when a new revision is created on an environment.
    ENVIRONMENT_REVISION_RETRACTEDenvironment_revision_retractedTrigger a webhook when a revision is retracted on an environment.
    ENVIRONMENT_REVISION_TAG_CREATEDenvironment_revision_tag_createdTrigger a webhook when a revision tag is created on an environment.
    ENVIRONMENT_REVISION_TAG_DELETEDenvironment_revision_tag_deletedTrigger a webhook when a revision tag is deleted on an environment.
    ENVIRONMENT_REVISION_TAG_UPDATEDenvironment_revision_tag_updatedTrigger a webhook when a revision tag is updated on an environment.
    ENVIRONMENT_TAG_CREATEDenvironment_tag_createdTrigger a webhook when an environment tag is created.
    ENVIRONMENT_TAG_DELETEDenvironment_tag_deletedTrigger a webhook when an environment tag is deleted.
    ENVIRONMENT_TAG_UPDATEDenvironment_tag_updatedTrigger a webhook when an environment tag is updated.
    IMPORTED_ENVIRONMENT_CHANGEDimported_environment_changedTrigger a webhook when an imported environment has changed.
    ENVIRONMENT_ROTATION_SUCCEEDEDenvironment_rotation_succeededTrigger a webhook when an environment rotation succeeds.
    ENVIRONMENT_ROTATION_FAILEDenvironment_rotation_failedTrigger a webhook when an environment rotation fails.
    ValueDescription
    stack_createdTrigger a webhook when a stack is created. Only valid for org webhooks.
    stack_deletedTrigger a webhook when a stack is deleted. Only valid for org webhooks.
    update_succeededTrigger a webhook when a stack update succeeds.
    update_failedTrigger a webhook when a stack update fails.
    preview_succeededTrigger a webhook when a stack preview succeeds.
    preview_failedTrigger a webhook when a stack preview fails.
    destroy_succeededTrigger a webhook when a stack destroy succeeds.
    destroy_failedTrigger a webhook when a stack destroy fails.
    refresh_succeededTrigger a webhook when a stack refresh succeeds.
    refresh_failedTrigger a webhook when a stack refresh fails.
    deployment_queuedTrigger a webhook when a deployment is queued.
    deployment_startedTrigger a webhook when a deployment starts running.
    deployment_succeededTrigger a webhook when a deployment succeeds.
    deployment_failedTrigger a webhook when a deployment fails.
    drift_detectedTrigger a webhook when drift is detected.
    drift_detection_succeededTrigger a webhook when a drift detection run succeeds, regardless of whether drift is detected.
    drift_detection_failedTrigger a webhook when a drift detection run fails.
    drift_remediation_succeededTrigger a webhook when a drift remediation run succeeds.
    drift_remediation_failedTrigger a webhook when a drift remediation run fails.
    environment_createdTrigger a webhook when a new environment is created.
    environment_deletedTrigger a webhook when an environment is deleted.
    environment_revision_createdTrigger a webhook when a new revision is created on an environment.
    environment_revision_retractedTrigger a webhook when a revision is retracted on an environment.
    environment_revision_tag_createdTrigger a webhook when a revision tag is created on an environment.
    environment_revision_tag_deletedTrigger a webhook when a revision tag is deleted on an environment.
    environment_revision_tag_updatedTrigger a webhook when a revision tag is updated on an environment.
    environment_tag_createdTrigger a webhook when an environment tag is created.
    environment_tag_deletedTrigger a webhook when an environment tag is deleted.
    environment_tag_updatedTrigger a webhook when an environment tag is updated.
    imported_environment_changedTrigger a webhook when an imported environment has changed.
    environment_rotation_succeededTrigger a webhook when an environment rotation succeeds.
    environment_rotation_failedTrigger a webhook when an environment rotation fails.

    WebhookFormat

    NameValueDescription
    RawrawThe default webhook format.
    SlackslackMessages formatted for consumption by Slack incoming webhooks.
    PulumiDeploymentspulumi_deploymentsInitiate deployments on a stack from a Pulumi Cloud webhook.
    MicrosoftTeamsms_teamsMessages formatted for consumption by Microsoft Teams incoming webhooks.
    NameValueDescription
    WebhookFormatRawrawThe default webhook format.
    WebhookFormatSlackslackMessages formatted for consumption by Slack incoming webhooks.
    WebhookFormatPulumiDeploymentspulumi_deploymentsInitiate deployments on a stack from a Pulumi Cloud webhook.
    WebhookFormatMicrosoftTeamsms_teamsMessages formatted for consumption by Microsoft Teams incoming webhooks.
    ValueDescription
    rawThe default webhook format.
    slackMessages formatted for consumption by Slack incoming webhooks.
    pulumi_deploymentsInitiate deployments on a stack from a Pulumi Cloud webhook.
    ms_teamsMessages formatted for consumption by Microsoft Teams incoming webhooks.
    NameValueDescription
    RawrawThe default webhook format.
    SlackslackMessages formatted for consumption by Slack incoming webhooks.
    PulumiDeploymentspulumi_deploymentsInitiate deployments on a stack from a Pulumi Cloud webhook.
    MicrosoftTeamsms_teamsMessages formatted for consumption by Microsoft Teams incoming webhooks.
    NameValueDescription
    RawrawThe default webhook format.
    SlackslackMessages formatted for consumption by Slack incoming webhooks.
    PulumiDeploymentspulumi_deploymentsInitiate deployments on a stack from a Pulumi Cloud webhook.
    MicrosoftTeamsms_teamsMessages formatted for consumption by Microsoft Teams incoming webhooks.
    NameValueDescription
    RAWrawThe default webhook format.
    SLACKslackMessages formatted for consumption by Slack incoming webhooks.
    PULUMI_DEPLOYMENTSpulumi_deploymentsInitiate deployments on a stack from a Pulumi Cloud webhook.
    MICROSOFT_TEAMSms_teamsMessages formatted for consumption by Microsoft Teams incoming webhooks.
    ValueDescription
    rawThe default webhook format.
    slackMessages formatted for consumption by Slack incoming webhooks.
    pulumi_deploymentsInitiate deployments on a stack from a Pulumi Cloud webhook.
    ms_teamsMessages formatted for consumption by Microsoft Teams incoming webhooks.

    WebhookGroup

    NameValueDescription
    StacksstacksA group of webhooks containing all stack events.
    DeploymentsdeploymentsA group of webhooks containing all deployment events.
    EnvironmentsenvironmentsA group of webhooks containing all environment events.
    NameValueDescription
    WebhookGroupStacksstacksA group of webhooks containing all stack events.
    WebhookGroupDeploymentsdeploymentsA group of webhooks containing all deployment events.
    WebhookGroupEnvironmentsenvironmentsA group of webhooks containing all environment events.
    ValueDescription
    stacksA group of webhooks containing all stack events.
    deploymentsA group of webhooks containing all deployment events.
    environmentsA group of webhooks containing all environment events.
    NameValueDescription
    StacksstacksA group of webhooks containing all stack events.
    DeploymentsdeploymentsA group of webhooks containing all deployment events.
    EnvironmentsenvironmentsA group of webhooks containing all environment events.
    NameValueDescription
    StacksstacksA group of webhooks containing all stack events.
    DeploymentsdeploymentsA group of webhooks containing all deployment events.
    EnvironmentsenvironmentsA group of webhooks containing all environment events.
    NameValueDescription
    STACKSstacksA group of webhooks containing all stack events.
    DEPLOYMENTSdeploymentsA group of webhooks containing all deployment events.
    ENVIRONMENTSenvironmentsA group of webhooks containing all environment events.
    ValueDescription
    stacksA group of webhooks containing all stack events.
    deploymentsA group of webhooks containing all deployment events.
    environmentsA group of webhooks containing all environment events.

    Import

    This resource can be imported using its id, which has the format {organization}/{project}/{stack}/{webhookName}, e.g.,

     $ pulumi import pulumiservice:index:Webhook my-webhook my-org/my-project/my-stack/4b0d0671
    

    Organization webhooks use {organization}/{webhookName}, and environment webhooks use {organization}/environment/{project}/{environment}/{webhookName}.

    The webhook name is the last segment of its page URL in the Pulumi Cloud console, for example https://app.pulumi.com/my-org/my-project/my-stack/settings/webhooks/4b0d0671. It’s an 8-character hex value that Pulumi Cloud assigned, not the webhook’s display name.

    The webhook’s secret can’t be read back from Pulumi Cloud, so it’s empty after import.

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    pulumiservice pulumi/pulumi-pulumiservice
    License
    Apache-2.0
    pulumiservice logo pulumiservice logo
    Viewing docs for Pulumi Cloud v1.8.0
    published on Thursday, Nov 19, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial