2016-09-26 22:14:08 +02:00
---
layout: "pagerduty"
page_title: "PagerDuty: pagerduty_team"
sidebar_current: "docs-pagerduty-resource-team"
description: |-
Creates and manages a team in PagerDuty.
---
# pagerduty\_team
A [team ](https://v2.developer.pagerduty.com/v2/page/api-reference#!/Teams/get_teams ) is a collection of users and escalation policies that represent a group of people within an organization.
2016-10-20 06:53:51 +02:00
The account must have the `teams` ability to use the following resource.
2016-09-26 22:14:08 +02:00
## Example Usage
2017-04-17 12:17:54 +02:00
```hcl
2016-09-26 22:14:08 +02:00
resource "pagerduty_team" "example" {
name = "Engineering"
description = "All engineering"
}
```
## Argument Reference
The following arguments are supported:
* `name` - (Required) The name of the group.
* `description` - (Optional) A human-friendly description of the team.
If not set, a placeholder of "Managed by Terraform" will be set.
## Attributes Reference
The following attributes are exported:
* `id` - The ID of the team.
2016-10-16 03:52:45 +02:00
## Import
Teams can be imported using the `id` , e.g.
```
$ terraform import pagerduty_team.main PLBP09X
```
