---
name: ContinuousDelivery-event_notifications_integration
title: Configuring Event Notifications
description: You can use the IBM Cloud® Event Notifications service to receive information about critical events that occur in your IBM Cloud® account. You can filter and route event notifications from IBM Cloud services like Toolchains, Monitoring, and Secrets Manager to communication channels like PagerDuty, Slack, email, SMS, push notifications, webhook, Microsoft® Teams, ServiceNow, and IBM Cloud Functions.
last-updated: 2026-07-23
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/ContinuousDelivery?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Configuring Event Notifications
{: #event-notifications-integration}

DevOps Insights will reach end of service and be discontinued on **August 31, 2026**. Continuous Delivery will be discontinued in the following regions on 12 February 2027: **au-syd**, **ca-mon**, **ca-tor**, **us-east**. Code Risk Analyzer will also be discontinued in all regions on that date. If a region has no active usage of these features, the features in that region may be discontinued earlier and stop accepting new instances. [Learn more](https://cloud.ibm.com/docs/ContinuousDelivery?topic=ContinuousDelivery-faq_region_feature_consolidation&format=markdown)
{: important}

You can use the IBM Cloud® Event Notifications service to receive information about critical events that occur in your IBM Cloud® account. You can filter and route event notifications from IBM Cloud services like Toolchains, Monitoring,  and Secrets Manager to communication channels like PagerDuty, Slack, email, SMS, push notifications, webhook, Microsoft® Teams, ServiceNow, and IBM Cloud Functions.
{: shortdesc}

Before you configure an Event Notifications tool integration, make sure that you provision an instance of the [Event Notifications](https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-getting-started&format=markdown) service.
{: important}

By connecting a toolchain to an Event Notifications service instance, the Event Notifications tool integration enables the toolchain and its associated tool integration instances to send built-in and client bespoke events to any of the destinations that are supported by the Event Notifications service. For more information about how toolchains process events, see [How events are collected and sent by toolchains](https://cloud.ibm.com/docs/ContinuousDelivery?topic=ContinuousDelivery-event-notifications-cd&format=markdown#event-notifications-how-cd).

Make sure that the selected Event Notifications service instance has an [IAM authorization policy](https://cloud.ibm.com/iam/authorizations/grant) that allows the toolchain to send events to this service instance. For more information about granting authorization with the Event Notifications service instance, see [Why am I denied permission to integrate an Event Notifications instance?](https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-troubleshoot-integrate&format=markdown).
{: important}

Configure Event Notifications to send critical events from toolchains and tool integration instances:

1. If you have a toolchain and are adding this tool integration to it, from the IBM Cloud console, click the **Menu** icon ![hamburger icon](images/icon_hamburger.svg) > **Platform Automation** > **Toolchains**. On the Toolchains page, click the toolchain to open its Overview page.

   a. Click **Add tool**.

   b. In the Tool Integrations section, click **Event Notifications**.

1. Type the name that you want to display for this tool integration on the Event Notifications card in your toolchain. This name is used to identify the tool integration in your toolchain.
1. Select the **Event Notifications** instance to connect the toolchain to.
1. Click **Create Integration** to add the Event Notifications tool integration to your toolchain.
1. On your Toolchain's Overview page, on the **IBM Cloud tools** card, click **Event Notifications**.

For more information about how to configure Event Notifications by using the API or Terraform, see [Enabling notifications](https://cloud.ibm.com/docs/ContinuousDelivery?topic=ContinuousDelivery-event-notifications-cd&interface=api&code=curl&format=markdown#event-notifications-enable-cd).

## Configuring Event Notifications by using the API
{: #event-notifications-config-parameters}

The Event Notifications tool integration supports the following configuration parameters that you can use with the [Toolchain HTTP API and SDKs](https://cloud.ibm.com/apis/toolchain){: external} when you [create](https://cloud.ibm.com/apis/toolchain#create-tool){: external}, [read](https://cloud.ibm.com/apis/toolchain#get-tool-by-id){: external}, and [update](https://cloud.ibm.com/apis/toolchain#update-tool){: external} tool integrations.

You must specify the `tool_type_id` property in the request body with the `eventnotifications` value.
{: important}

| Parameter | Usage | Type | Terraform argument | Description |
| --- | --- | --- | --- | --- |
| name | required, updatable | String | name | The name of this tool integration. |
| instance-crn  | required, updatable | String | instance_crn | The Cloud Resource Name (CRN) of the Event Notifications service instance. |
{: caption="Event Notifications tool integration parameters" caption-side="bottom"}

## Enabling notifications for Tekton Pipelines
{: #event_notifications_tekton_pipelines}

You can configure a Tekton Pipeline to send events to Event Notifications integrations.

1. From your toolchain's Overview page, on the **Delivery pipelines** card, click the **Delivery Pipeline** to open the Tekton Delivery Pipeline dashboard.
1. On the **Settings** > **Advanced Settings** page, enable **Event Notifications**.
1. Save your changes.

## Learn more about Event Notifications
{: #learn_event_notifications}

To learn more about Event Notifications, see [Getting started with Event Notifications](https://cloud.ibm.com/docs/event-notifications?topic=event-notifications-getting-started&format=markdown).