---
title: "uptimeify_im_alert_source"
description: "Look up one Incident Management alert source by id or by name (exactly one). Fails when no or several sources match the name. Tokens and secrets are never returned."
---

Look up one Incident Management alert source by `id` or by `name` (exactly one). Fails when no or several sources match the name. Tokens and secrets are never returned.

## Example Usage

```terraform
data "uptimeify_im_alert_source" "zabbix" {
  name = "Zabbix"
}

output "zabbix_title_selector" {
  value = data.uptimeify_im_alert_source.zabbix.payload_mapping.title
}
```

## Schema

### Optional

- `id` (String) Numeric source id.
- `name` (String)

### Read-Only

- `auto_resolve` (Boolean) Resolve the incident when the vendor sends a resolve. Default `true`.
- `bearer_enabled` (Boolean) Require `Authorization: Bearer <bearer_token>`. Enabling it the first time mints the token.
- `created_at` (String)
- `grouping_window_minutes` (Number) Group alerts arriving within this many minutes into one incident. Unset = group by dedup key only.
- `hmac_enabled` (Boolean) Require an HMAC signature. Enabling needs a secret: set `hmac_secret_wo` (once is enough, disabling keeps the secret stored).
- `maintenance_windows` (Attributes List) Recurring windows in which alerts are stored as suppressed instead of opening incidents. At most 20. (see [below for nested schema](#nested-schema-for-maintenance_windows))
- `organization_id` (Number)
- `payload_mapping` (Attributes) How a vendor payload becomes an alert. Either the v2 `attributes` list or the v1 selector fields (`title`, `severity`, `status`, ...). Unset = not managed: the server keeps its mapping (a preset type starts with the preset mapping; read it with the data source); removing the block later keeps the last mapping. An import reads the stored mapping. Must stay unset for `type = "email"` (the server builds that mapping). (see [below for nested schema](#nested-schema-for-payload_mapping))
- `secondary_expires_at` (String) End of the grace period of the previous ingest token after a rotation.
- `team_id` (Number) Team that owns incidents from this source.
- `type` (String) A preset name from `GET /api/im/sources/presets` (e.g. `zabbix`, `datadog`, `grafana`, `alertmanager`, `sentry`, `beszel`, `custom`), `api` (no webhook URL, fed by `POST /api/im/events`) or `email`. Changing it replaces the source.
- `updated_at` (String)
- `url_token_enabled` (Boolean) `authMode.urlToken`. The server stores the flag; unset = not sent.

### Nested Schema for `maintenance_windows`

Read-Only:

- `days_of_week` (List of Number) ISO weekdays, 1 = Monday to 7 = Sunday. Unset = every day.
- `from` (String) `HH:MM`, 24 h.
- `timezone` (String) IANA zone. Unset = the organization zone.
- `to` (String) `HH:MM`, 24 h.


### Nested Schema for `payload_mapping`

Read-Only:

- `attributes` (Attributes List) v2 attribute-list mapping: ordered attributes, each with a step chain. (see [below for nested schema](#nested-schema-for-payload_mappingattributes))
- `custom` (Map of String) v1: extra field -> selector.
- `dedup_key` (String) v1: selector of the dedup key.
- `default_severity` (String) Severity when the mapping yields none. The server treats unset as `sev3`.
- `email_selectors` (Map of String) email sources: field -> email selector. The server builds it on create; read here.
- `host` (String) v1: selector of the host.
- `resolve_values` (List of String) v1: status values that resolve the alert.
- `severity` (String) v1: selector of the vendor severity.
- `severity_map` (Map of String) v1: vendor value -> `sev1`..`sev4`.
- `status` (String) v1: selector of the vendor status.
- `title` (String) v1: selector of the alert title.
- `url` (String) v1: selector of the URL.

### Nested Schema for `payload_mapping.attributes`

Read-Only:

- `flags` (Attributes) (see [below for nested schema](#nested-schema-for-payload_mappingattributesflags))
- `key` (String)
- `standard` (Boolean) A standard alert field (title, severity, status, ...).
- `steps` (Attributes List) (see [below for nested schema](#nested-schema-for-payload_mappingattributessteps))

### Nested Schema for `payload_mapping.attributes.flags`

Read-Only:

- `expand` (Boolean)
- `grouped` (Boolean)
- `hidden` (Boolean)
- `image` (Boolean)


### Nested Schema for `payload_mapping.attributes.steps`

Read-Only:

- `entries` (Attributes List) valueMap: from -> to pairs. (see [below for nested schema](#nested-schema-for-payload_mappingattributesstepsentries))
- `expr` (String) extract: the expression.
- `fallback` (String) valueMap: value when no entry matches.
- `kind` (String) `extract` or `valueMap`.
- `type` (String) extract: `path`, `jsonpath` or `constant`.

### Nested Schema for `payload_mapping.attributes.steps.entries`

Read-Only:

- `from` (String)
- `to` (String)