From fddefa6f33ec18c75a8c72f53c739a851ebd52d2 Mon Sep 17 00:00:00 2001
From: Alexander Hellbom <alexander.hellbom@gmail.com>
Date: Sun, 16 Oct 2016 19:01:27 +0200
Subject: [PATCH] Add documentation for `service_integration`

---
 .../r/service_integration.html.markdown       | 72 +++++++++++++++++++
 website/source/layouts/pagerduty.erb          |  3 +
 2 files changed, 75 insertions(+)
 create mode 100644 website/source/docs/providers/pagerduty/r/service_integration.html.markdown

diff --git a/website/source/docs/providers/pagerduty/r/service_integration.html.markdown b/website/source/docs/providers/pagerduty/r/service_integration.html.markdown
new file mode 100644
index 000000000..e37bf8606
--- /dev/null
+++ b/website/source/docs/providers/pagerduty/r/service_integration.html.markdown
@@ -0,0 +1,72 @@
+---
+layout: "pagerduty"
+page_title: "PagerDuty: pagerduty_service_integration"
+sidebar_current: "docs-pagerduty-resource-service-integration"
+description: |-
+  Creates and manages a service integration in PagerDuty.
+---
+
+# pagerduty\_service_integration
+
+A [service integration](https://v2.developer.pagerduty.com/v2/page/api-reference#!/Services/post_services_id_integrations) is an integration that belongs to a service.
+
+
+## Example Usage
+
+```
+resource "pagerduty_user" "example" {
+    name  = "Earline Greenholt"
+    email = "125.greenholt.earline@graham.name"
+    teams = ["${pagerduty_team.example.id}"]
+}
+
+resource "pagerduty_escalation_policy" "foo" {
+  name      = "Engineering Escalation Policy"
+  num_loops = 2
+
+  escalation_rule {
+    escalation_delay_in_minutes = 10
+
+    target {
+      type = "user"
+      id   = "${pagerduty_user.example.id}"
+    }
+  }
+}
+
+resource "pagerduty_service" "example" {
+  name                    = "My Web App"
+  auto_resolve_timeout    = 14400
+  acknowledgement_timeout = 600
+  escalation_policy       = "${pagerduty_escalation_policy.example.id}"
+}
+
+resource "pagerduty_service_integration" "example" {
+  name    = "Generic API Service Integration"
+  type    = "generic_events_api_inbound_integration"
+  service = "${pagerduty_service.example.id}"
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+  * `name` - (Optional) The name of the service integration.
+  * `type` - (Optional) The service type. Can be `aws_cloudwatch_inbound_integration`, `cloudkick_inbound_integration`,
+  `event_transformer_api_inbound_integration`,
+  `generic_email_inbound_integration`,
+  `generic_events_api_inbound_integration`,
+  `keynote_inbound_integration`,
+  `nagios_inbound_integration`,
+  `pingdom_inbound_integration`,
+  `sql_monitor_inbound_integration`
+  * `service` - (Optional) The PagerDuty service that the integration belongs to.
+
+## Attributes Reference
+
+The following attributes are exported:
+
+  * `id` - The ID of the service integration.
+  * `integration_key` - This is the unique key used to route events to this integration when received via the PagerDuty Events API.
+  * `integration_email` - This is the unique fully-qualified email address used for routing emails to this integration for processing.
diff --git a/website/source/layouts/pagerduty.erb b/website/source/layouts/pagerduty.erb
index 4a5af0cc1..164b831e8 100644
--- a/website/source/layouts/pagerduty.erb
+++ b/website/source/layouts/pagerduty.erb
@@ -28,6 +28,9 @@
 						<li<%= sidebar_current("docs-pagerduty-resource-service") %>>
 							<a href="/docs/providers/pagerduty/r/service.html">pagerduty_service</a>
 						</li>
+            <li<%= sidebar_current("docs-pagerduty-resource-service-integration") %>>
+							<a href="/docs/providers/pagerduty/r/service_integration.html">pagerduty_service_integration</a>
+						</li>
           </ul>
         </li>
       </ul>