github_repository_webhook

This resource allows you to create and manage webhooks for repositories within your Github organization.

This resource cannot currently be used to manage webhooks for personal repositories, outside of organizations.

Example Usage

resource "github_repository" "repo" {
  name         = "foo"
  description  = "Terraform acceptance tests"
  homepage_url = "http://example.com/"

  private = false
}

resource "github_repository_webhook" "foo" {
  repository = "${github_repository.repo.name}"

  name = "web"

  configuration {
    url          = "https://google.de/"
    content_type = "form"
    insecure_ssl = false
  }

  active = false

  events = ["issues"]
}

Argument Reference

The following arguments are supported:

  • name - (Required) The type of the webhook. See a list of available hooks.

  • repository - (Required) The repository of the webhook.

  • events - (Required) A list of events which should trigger the webhook. See a list of available events

  • configuration - (Required) key/value pair of configuration for this webhook. Available keys are url, content_type, secret and insecure_ssl.

  • active - (Optional) Indicate of the webhook should receive events. Defaults to true.

Attributes Reference

The following additional attributes are exported:

  • url - URL of the webhook

Import

Repository Webhooks can be imported using the name of the repository, combined with the id of the webhook, separated by a / character. The id of the webhook can be found in the URL of the webhook. For example: "https://github.com/foo-org/foo-repo/settings/hooks/14711452".

Importing uses the name of the repository, as well as the ID of the webhook, e.g.

$ terraform import github_repository_webhook.terraform terraform/11235813

© 2018 HashiCorp
Licensed under the MPL 2.0 License.
https://www.terraform.io/docs/providers/github/r/repository_webhook.html