If 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​

ParameterDescription
Escalation Policy IDThe ID of the Escalation Policy for all policies see listEscalationPolicies.
Service Alert CreationWhether 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.
  • “createalertsand_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"        }    }}

​
Workflow Library Example​

Create Service with Pagerduty and Send Results Via Email

Preview this Workflow on desktop