Skip to content

pagerduty create-service

Create a new service.


A service may represent an application, component, or team you wish to open incidents against.


pagerduty create-service
    --site <site>
    --name <name>
    --escalation_policy <escalation_policy>
    [--description <description>]
    [--auto_resolve_timeout <auto_resolve_timeout>]
    [--acknowledgement_timeout <acknowledgement_timeout>]
    [--status <status>]


site - (string)

     Site where this command will be executed
     Example: --site "site-1"
     Default:      Attributes: required

name - (string)

     The name of the service.
     Example: --name "Test Service"
     Default: _None_      Attributes: required

escalation_policy - (string)

     id for escalation policy
     Example: --escalation_policy "escalation_policy-1"
     Default: _None_      Attributes: required

description - (string)

     The user-provided description of the service.
     Example: --description "Test description"
     Default: _None_      Attributes: optional

auto_resolve_timeout - (int)

     Time in seconds that an incident is automatically resolved.
     Example: --auto_resolve_timeout 1
     Default: 14400      Attributes: optional

acknowledgement_timeout - (int)

     Time in seconds that an incident changes to the Triggered State after being Acknowledged.
     Example: --acknowledgement_timeout 1
     Default: 1800      Attributes: optional

status - (string)

     The current state of the Service.
     Example: --status "status-1"
     Default: active      Attributes: optional

         allowed values: active, warning, critical, maintenance, disabled


pagerduty create-service --name "Test Service" --escalation_policy "escalation_policy-1" --description "Test description"

Access Control

To use this command, you need access to the following:

Field Value
Action "create"
Service Type "pagerduty"
Service Instance
Object Type "service"
Object ID

Please see Access Control for details.