1 files changed, 51 insertions, 0 deletions
diff --git a/integrations/cloud-notifications/integrations/pagerduty.md b/integrations/cloud-notifications/integrations/pagerduty.md
new file mode 100644
index 000000000..eafb6ceb3
--- /dev/null
+++ b/integrations/cloud-notifications/integrations/pagerduty.md
@@ -0,0 +1,51 @@
+<!--startmeta
+custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/integrations/pagerduty.md"
+meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml"
+sidebar_label: "PagerDuty"
+learn_status: "Published"
+learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications"
+message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE"
+endmeta-->
+
+# PagerDuty
+
+
+<img src="https://netdata.cloud/img/pagerduty.png" width="150"/>
+
+
+From the Netdata Cloud UI, you can manage your space's notification settings and enable the configuration to deliver notifications on PagerDuty.
+
+
+<img src="https://img.shields.io/badge/maintained%20by-Netdata-%2300ab44" />
+
+## Setup
+
+### Prerequisites
+- A Netdata Cloud account
+- Access to the Netdata Space as an **administrator**
+- The Netdata Space needs to be on **Business** plan or higher
+- You need to have a PagerDuty service to receive events using webhooks.
+
+
+### PagerDuty Server Configuration
+Steps to configure your PagerDuty to receive notifications from Netdata:
+
+1. Create a service to receive events from your services directory page on PagerDuty
+2. At step 3, select `Events API V2` Integration or **View Webhooks** if you already have some defined
+3. Once the service is created you will be redirected to its configuration page, where you can copy the **integration key**, that you will need need to add to your notification configuration on Netdata UI.
+
+### Netdata Configuration Steps
+
+1. Click on the **Space settings** cog (located above your profile icon)
+2. Click on the **Notification** tab
+3. Click on the **+ Add configuration** button (near the top-right corner of your screen)
+4. On the **PagerDuty** card click on **+ Add**
+5. A modal will be presented to you to enter the required details to enable the configuration:
+  * **Notification settings** are Netdata specific settings
+    - Configuration name - you can optionally provide a name for your configuration you can easily refer to it
+    - Rooms - by specifying a list of Rooms you are select to which nodes or areas of your infrastructure you want to be notified using this configuration
+    - Notification - you specify which notifications you want to be notified using this configuration: All Alerts and unreachable, All Alerts, Critical only
+  * **Integration configuration** are the specific notification integration required settings, which vary by notification method. For PagerDuty:
+    - Integration Key - is a 32 character key provided by PagerDuty to receive events on your service.
+
+