---
title: Configuring the SMTP alert handler
description: To create a new instance of an SMTP alert handler, use the dsconfig tool.
component: pingdirectory
version: 11.0
page_id: pingdirectory:pingdirectoryproxy_server_administration_guide:pd_proxy_config_smtp_alert_handler
canonical_url: https://docs.pingidentity.com/pingdirectory/11.0/pingdirectoryproxy_server_administration_guide/pd_proxy_config_smtp_alert_handler.html
revdate: July 5, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
  example: Example:
---

# Configuring the SMTP alert handler

To create a new instance of an SMTP alert handler, use the `dsconfig` tool.

## About this task

By default, there is no configuration entry for an SMTP alert handler.

## Steps

* Use the `dsconfig` tool to configure the SMTP Alert Handler.

  ### Example:

  ```shell
  $ bin/dsconfig create-alert-handler \
    --handler-name "SMTP Alert Handler" \
    --type smtp \
    --set enabled:true \
    --set "sender-address:alerts@example.com" \
    --set "recipient-address:administrators@example.com" \
    --set "message-subject:Directory Admin Alert \%\%alert-type\%\%" \
    --set "message-body:Administrative alert:\\n\%\%alert-message\%\%"
  ```