terraform/website/source/docs/providers/pagerduty/index.html.markdown

---
layout: "pagerduty"
page_title: "Provider: PagerDuty"
sidebar_current: "docs-pagerduty-index"
description: |-
  PagerDuty is an alarm aggregation and dispatching service
---

# PagerDuty Provider

[PagerDuty](https://www.pagerduty.com/) is an alarm aggregation and dispatching service for system administrators and support teams. It collects alerts from your monitoring tools, gives you an overall view of all of your monitoring alarms, and alerts an on duty engineer if there’s a problem.

Use the navigation to the left to read about the available resources.

## Example Usage

```
# Configure the PagerDuty provider
provider "pagerduty" {
    token = "${var.pagerduty_token}"
}

# Create a PagerDuty team
resource "pagerduty_team" "engineering" {
    name        = "Engineering"
    description = "All engineering"
}

# Create a PagerDuty user
resource "pagerduty_user" "earline" {
    name  = "Earline Greenholt"
    email = "125.greenholt.earline@graham.name"
    teams = ["${pagerduty_team.engineering.id}"]
}
```

## Argument Reference

The following arguments are supported:

* `token` - (Required) The v2 authorization token. See [API Documentation](https://v2.developer.pagerduty.com/docs/authentication) for more information.