---
title: "uptimeify_im_outbound_integration"
description: "Ressource uptimeify_im_outbound_integration: Beispiel, alle Attribute, Import."
---

<Callout>Die Beschreibungen auf dieser Seite kommen direkt aus dem Provider-Schema und sind deshalb englisch.</Callout>

An Incident Management outbound integration: forwards incident events to Slack, Microsoft Teams, Discord, Jira, PagerDuty (Events v2), Opsgenie or a generic webhook. Incident Management must be active for the organization. URLs, tokens, keys and header values are secrets the API never returns, so they are write-only here; `has_*` tells whether one is stored. Import with the numeric id.

## Beispiel

```terraform
variable "teams_webhook_url" {
  type      = string
  sensitive = true
}

variable "jira_api_token" {
  type      = string
  sensitive = true
}

# Post every sev1/sev2 incident event of the platform team to a Microsoft Teams channel.
resource "uptimeify_im_outbound_integration" "teams" {
  name               = "Platform Teams"
  type               = "teams"
  team_id            = 7
  filter_severities  = ["sev1", "sev2"]
  webhook_url_wo     = var.teams_webhook_url
  secrets_wo_version = 1
}

# Open a Jira issue per new incident (the server default event_kinds for jira).
resource "uptimeify_im_outbound_integration" "jira" {
  name         = "Jira OPS"
  type         = "jira"
  email        = "bot@example.com"
  base_url     = "https://example.atlassian.net"
  project_key  = "OPS"
  api_token_wo = var.jira_api_token
}
```

## Schema

### Pflichtfelder

- `name` (String) 1 to 200 characters, no surrounding whitespace.
- `type` (String) `slack`, `teams`, `discord`, `jira`, `pagerduty_v2`, `opsgenie` or `webhook`. Changing it replaces the integration.

### Optional

> **NOTE**: [Write-only arguments](https://developer.hashicorp.com/terraform/language/resources/ephemeral#write-only-arguments) are supported in Terraform 1.11 and later.

- `api_key_wo` (String, Sensitive, [Write-only](https://developer.hashicorp.com/terraform/language/resources/ephemeral#write-only-arguments)) `opsgenie`: API key, required. Write-only: sent on create and whenever `secrets_wo_version` changes.
- `api_token_wo` (String, Sensitive, [Write-only](https://developer.hashicorp.com/terraform/language/resources/ephemeral#write-only-arguments)) `jira`: API token, required. Write-only: sent on create and whenever `secrets_wo_version` changes.
- `base_url` (String) `jira`: site URL, https only, required.
- `bearer_token_wo` (String, Sensitive, [Write-only](https://developer.hashicorp.com/terraform/language/resources/ephemeral#write-only-arguments)) `webhook`: sent as `Authorization: Bearer`. Write-only: sent on create and whenever `secrets_wo_version` changes.
- `email` (String) `jira`: account email, required.
- `event_kinds` (List of String) Events to forward: `incident_created`, `acknowledged`, `severity_changed`, `status_changed`, `comment`, `resolved`. Unset = all, except `jira`, where the server stores `["incident_created"]`. Removing it from the configuration keeps the stored list.
- `filter_severities` (List of String) Only these severities, `sev1` to `sev4`. Unset = all.
- `filter_team_ids` (List of Number) Only incidents of these teams (of the organization). Unset = all.
- `headers_wo` (Map of String, Sensitive, [Write-only](https://developer.hashicorp.com/terraform/language/resources/ephemeral#write-only-arguments)) `webhook`: extra request headers. Write-only: sent on create and whenever `secrets_wo_version` changes, then replacing the stored set (unset = remove all).
- `is_active` (Boolean) Default `true`.
- `project_key` (String) `jira`: project key, required.
- `routing_key_wo` (String, Sensitive, [Write-only](https://developer.hashicorp.com/terraform/language/resources/ephemeral#write-only-arguments)) `pagerduty_v2`: integration routing key, required. Write-only: sent on create and whenever `secrets_wo_version` changes.
- `secrets_wo_version` (Number) Change to resend every `*_wo` value.
- `team_id` (Number) Owning team; unset = organization-wide (needs an org admin).
- `webhook_url_wo` (String, Sensitive, [Write-only](https://developer.hashicorp.com/terraform/language/resources/ephemeral#write-only-arguments)) `slack`/`teams`/`discord`/`webhook`: target URL (public http(s)), required. Write-only: sent on create and whenever `secrets_wo_version` changes.

### Nur lesbar

- `created_at` (String)
- `has_api_key` (Boolean) Whether an Opsgenie API key is stored.
- `has_api_token` (Boolean) Whether a Jira API token is stored.
- `has_bearer_token` (Boolean) Whether a bearer token is stored.
- `has_headers` (Boolean) Whether custom headers are stored.
- `has_routing_key` (Boolean) Whether a PagerDuty routing key is stored.
- `has_webhook_url` (Boolean) Whether a webhook URL is stored.
- `id` (String) Numeric integration id.
- `organization_id` (Number)
- `updated_at` (String)

## Import

Import geht so:

Mit [`tofu import` bzw. `terraform import`](https://developer.hashicorp.com/terraform/cli/commands/import), zum Beispiel:

```shell
terraform import uptimeify_im_outbound_integration.jira 21
```