# Managing Receivers

Receivers are the event sinks associated to senlin clusters. When certain events (or alarms) are seen by a monitoring software, the software can notify the senlin clusters of those events (or alarms). When senlin receives those notifications, it can automatically trigger some predefined operations with preset parameter values.

## List Receivers

To examine the list of receivers:

When listing receivers, you can specify the sorting option using the `sort` parameter and you can do pagination using the `limit` and `marker` parameters.

Full example: manage receiver

## Create Receiver

When creating a receiver, you will provide a dictionary with keys and values according to the receiver type referenced.

Optionally, you can specify a `metadata` keyword argument that contains some key-value pairs to be associated with the receiver.

Full example: manage receiver

## Get Receiver

To get a receiver based on its name or ID:

Full example: manage receiver

## Find Receiver

To find a receiver based on its name or ID:

Full example: manage receiver

## Update Receiver

After a receiver is created, most of its properties are immutable. Still, you can update a receiver’s `name` and/or `params`.

Full example: manage receiver

## Delete Receiver

A receiver can be deleted after creation, provided that it is not referenced by any active clusters. If you attempt to delete a receiver that is still in use, you will get an error message.

this page last updated: 2026-01-16 23:06:19

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.