status is included in the request, it must have a value of active when creating a new service. If a different status is required, make a second request to update the service.
A service may represent an application, component, or team you wish to open incidents against.
For more information see the Parameters
| Parameter | Description |
|---|---|
| Escalation Policy ID | The ID of the Escalation Policy for all policies see listEscalationPolicies. |
| Service Alert Creation | Whether a service creates only incidents, or both alerts and incidents. A service must create alerts in order to enable incident merging. * “create_incidents” - The service will create one incident and zero alerts for each incoming event. * “create_alerts_and_incidents” - The service will create one incident and one associated alert for each incoming event. |
| Service Description | The user-provided description of the service. |
| Service Integrations | An array containing Integration objects that belong to this service. If integrations is passed as an argument, these are full objects - otherwise, these are references. |
| Service Name | The name of the service. |
Example Output
{
"summary": "Response Example",
"value": {
"service": {
"acknowledgement_timeout": 600,
"alert_creation": "create_alerts_and_incidents",
"auto_resolve_timeout": 14400,
"created_at": "2015-11-06T11:12:51-05:00",
"escalation_policy": {
"html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA",
"id": "PT20YPA",
"self": "https://api.pagerduty.com/escalation_policies/PT20YPA",
"summary": "Another Escalation Policy",
"type": "escalation_policy_reference"
},
"html_url": "https://subdomain.pagerduty.com/services/PIJ90N7",
"id": "PIJ90N7",
"incident_urgency_rule": {
"during_support_hours": {
"type": "constant",
"urgency": "high"
},
"outside_support_hours": {
"type": "constant",
"urgency": "low"
},
"type": "use_support_hours"
},
"integrations": [
{
"html_url": "https://subdomain.pagerduty.com/services/PIJ90N7/integrations/PQ12345",
"id": "PQ12345",
"self": "https://api.pagerduty.com/services/PIJ90N7/integrations/PQ12345",
"summary": "Email Integration",
"type": "generic_email_inbound_integration_reference"
}
],
"name": "My Application Service",
"scheduled_actions": [
{
"at": {
"name": "support_hours_start",
"type": "named_time"
},
"to_urgency": "high",
"type": "urgency_change"
}
],
"self": "https://api.pagerduty.com/services/PIJ90N7",
"status": "active",
"summary": "My Application Service",
"support_hours": {
"days_of_week": [
1,
2,
3,
4,
5
],
"end_time": "17:00:00",
"start_time": "09:00:00",
"time_zone": "America/Lima",
"type": "fixed_time_per_day"
},
"teams": [
{
"html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8",
"id": "PQ9K7I8",
"self": "https://api.pagerduty.com/teams/PQ9K7I8",
"summary": "Engineering",
"type": "team_reference"
}
],
"type": "service"
}
}
}