# <a id="bitdrift.public.unary.admin.v1.NotificationGroup"></a>NotificationGroup

**Source definition:** [`src/bitdrift/public/unary/admin/v1/notifications.proto#L15-L95`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/unary/admin/v1/notifications.proto#L15-L95>)

Defines a reusable set of notification targets for the organization.

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| name | <span class="proto-type proto-type-primitive">string</span><br><em class="proto-field-annotation">between 1 and 255 chars</em> | The name of the notification group. Must be unique. |
| slack_channels | <span class="proto-type proto-type-primitive">array of string</span><br><em class="proto-field-annotation">up to 100 items</em> | The list of Slack channel names that are members of the notification group. |
| pager_duty_notifications | <span class="proto-type proto-type-message">array of [<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">unary</i><i class="proto-type-dot">.</i><i class="proto-type-part">admin</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">NotificationGroup</i><i class="proto-type-dot">.</i><i class="proto-type-part">PagerDutyNotification</i>](#bitdrift.public.unary.admin.v1.NotificationGroup.PagerDutyNotification "bitdrift.public.unary.admin.v1.NotificationGroup.PagerDutyNotification")</span><br><em class="proto-field-annotation">up to 100 items</em> | The list of PagerDuty targets that are members of the notification group. |
| email_addresses | <span class="proto-type proto-type-primitive">array of string</span><br><em class="proto-field-annotation">up to 100 items</em> | The list of email addresses that are members of the notification group. |
| sns_topic_arns | <span class="proto-type proto-type-primitive">array of string</span><br><em class="proto-field-annotation">up to 100 items</em> | The list of SNS topic ARNs that are members of the notification group. |
| datadog_notifications | <span class="proto-type proto-type-message">array of [<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">unary</i><i class="proto-type-dot">.</i><i class="proto-type-part">admin</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">NotificationGroup</i><i class="proto-type-dot">.</i><i class="proto-type-part">DataDogNotification</i>](#bitdrift.public.unary.admin.v1.NotificationGroup.DataDogNotification "bitdrift.public.unary.admin.v1.NotificationGroup.DataDogNotification")</span><br><em class="proto-field-annotation">up to 100 items</em> | The list of DataDog On-Call targets that are members of the notification group. |

</section>
<p class="h4">Example</p>
```json
{
  "datadog_notifications": [
    {
      "api_base_url": "https://navy.oncall.datadoghq.com",
      "api_key": "datadog-api-key",
      "application_key": "datadog-application-key",
      "severity": "HIGH",
      "team_handle": "backend-oncall"
    }
  ],
  "email_addresses": [
    "user@example.com"
  ],
  "name": "engineering-oncall",
  "pager_duty_notifications": [
    {
      "routing_key": "pagerduty-routing-key",
      "severity": "CRITICAL"
    }
  ],
  "slack_channels": [
    "#incident-response"
  ],
  "sns_topic_arns": [
    "arn:aws:sns:us-east-1:123456789012:incident-notifications"
  ]
}
```

# <a id="bitdrift.public.unary.admin.v1.NotificationGroup.PagerDutyNotification"></a>NotificationGroup.PagerDutyNotification

**Source definition:** [`src/bitdrift/public/unary/admin/v1/notifications.proto#L17-L33`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/unary/admin/v1/notifications.proto#L17-L33>)

Describes a PagerDuty target in a notification group.

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| routing_key | <span class="proto-type proto-type-primitive">string</span><br><em class="proto-field-annotation">between 1 and 255 chars</em> | Routing key for the PagerDuty integration to notify. |
| severity | <span class="proto-type proto-type-enum">[<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">unary</i><i class="proto-type-dot">.</i><i class="proto-type-part">admin</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">NotificationGroup</i><i class="proto-type-dot">.</i><i class="proto-type-part">PagerDutyNotification</i><i class="proto-type-dot">.</i><i class="proto-type-part">PagerDutySeverity</i>](#bitdrift.public.unary.admin.v1.NotificationGroup.PagerDutyNotification.PagerDutySeverity "bitdrift.public.unary.admin.v1.NotificationGroup.PagerDutyNotification.PagerDutySeverity")</span><br><em class="proto-field-annotation">must be a defined enum value</em> | Severity sent with the PagerDuty incident. |

</section>
<p class="h4">Example</p>
```json
{
  "routing_key": "pagerduty-routing-key",
  "severity": "CRITICAL"
}
```

# <a id="bitdrift.public.unary.admin.v1.NotificationGroup.PagerDutyNotification.PagerDutySeverity"></a>NotificationGroup.PagerDutyNotification.PagerDutySeverity <em class="proto-enum">Enum</em>

**Source definition:** [`src/bitdrift/public/unary/admin/v1/notifications.proto#L18-L23`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/unary/admin/v1/notifications.proto#L18-L23>)

| Name | Description |
|---|---|
| CRITICAL |  |
| ERROR |  |
| WARNING |  |
| INFO |  |

# <a id="bitdrift.public.unary.admin.v1.NotificationGroup.DataDogNotification"></a>NotificationGroup.DataDogNotification

**Source definition:** [`src/bitdrift/public/unary/admin/v1/notifications.proto#L36-L73`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/unary/admin/v1/notifications.proto#L36-L73>)

Describes a Datadog On-Call target in a notification group.

<section class="proto-fields-table" markdown>
| Field | Type | Description |
|---|---|---|
| api_base_url | <span class="proto-type proto-type-primitive">string</span><br><em class="proto-field-annotation">between 1 and 255 chars</em> | The base URL for the DataDog On-Call API, for example https://navy.oncall.datadoghq.com. |
| api_key | <span class="proto-type proto-type-primitive">string</span><br><em class="proto-field-annotation">between 1 and 255 chars</em> | The DataDog API key. GetNotificationGroups returns this as <redacted> after creation.  UpsertNotificationGroup accepts <redacted> to preserve the stored value for an existing  target. |
| application_key | <span class="proto-type proto-type-primitive">string</span><br><em class="proto-field-annotation">between 1 and 255 chars</em> | The DataDog application key. GetNotificationGroups returns this as <redacted> after  creation. UpsertNotificationGroup accepts <redacted> to preserve the stored value for an  existing target. |
| team_handle | <span class="proto-type proto-type-primitive">string</span><br><em class="proto-field-annotation">between 1 and 255 chars</em> | The DataDog team handle to page. |
| severity | <span class="proto-type proto-type-enum">[<i class="proto-type-part">bitdrift</i><i class="proto-type-dot">.</i><i class="proto-type-part">public</i><i class="proto-type-dot">.</i><i class="proto-type-part">unary</i><i class="proto-type-dot">.</i><i class="proto-type-part">admin</i><i class="proto-type-dot">.</i><i class="proto-type-part">v1</i><i class="proto-type-dot">.</i><i class="proto-type-part">NotificationGroup</i><i class="proto-type-dot">.</i><i class="proto-type-part">DataDogNotification</i><i class="proto-type-dot">.</i><i class="proto-type-part">DataDogSeverity</i>](#bitdrift.public.unary.admin.v1.NotificationGroup.DataDogNotification.DataDogSeverity "bitdrift.public.unary.admin.v1.NotificationGroup.DataDogNotification.DataDogSeverity")</span><br><em class="proto-field-annotation">must be a defined enum value</em> | The requested paging urgency. |

</section>
<p class="h4">Example</p>
```json
{
  "api_base_url": "https://navy.oncall.datadoghq.com",
  "api_key": "datadog-api-key",
  "application_key": "datadog-application-key",
  "severity": "HIGH",
  "team_handle": "backend-oncall"
}
```

# <a id="bitdrift.public.unary.admin.v1.NotificationGroup.DataDogNotification.DataDogSeverity"></a>NotificationGroup.DataDogNotification.DataDogSeverity <em class="proto-enum">Enum</em>

**Source definition:** [`src/bitdrift/public/unary/admin/v1/notifications.proto#L37-L41`](<https://github.com/bitdriftlabs/api/blob/main/src/bitdrift/public/unary/admin/v1/notifications.proto#L37-L41>)

| Name | Description |
|---|---|
| SEVERITY_UNSPECIFIED |  |
| LOW |  |
| HIGH |  |

