Skip to content

pagerduty create-user

Add user to your PagerDuty account.


Add a user from your PagerDuty account.


pagerduty create-user
    --site <site>
    --from <from>
    --name <name>
    --email <email>
    [--role <role>]
    [--title <title>]
    [--license_id <license_id>]


site - (string)

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

from - (string)

     Email address of a valid user associated with the account making the request.
     Example: --from "from-1"
     Default: _None_      Attributes: required

name - (string)

     The name of the user.
     Example: --name "FirstName LastName"
     Default: _None_      Attributes: required

email - (string)

     The user's email address.
     Example: --email ""
     Default: _None_      Attributes: required

role - (string)

     The user role.
     Example: --role "user"
     Default: _None_      Attributes: optional

         allowed values: admin, limited_user, observer, owner, read_only_user, restricted_access, read_only_limited_user, user

title - (string)

     The job title for the user.
     Example: --title "Director of Marketing"
     Default: _None_      Attributes: optional

         max length: 100

license_id - (string)

     License id assigned to the User
     Example: --license_id "license_id-1"
     Default: _None_      Attributes: optional


pagerduty create-user --from "from-1" --name "FirstName LastName" --email "" --role "user" --title "Director of Marketing" --license_id "license_id-1"

Access Control

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

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

Please see Access Control for details.