Create User

Create a new user profile within your PagerDuty instance.

Unless otherwise indicated, field types are text.



  • Email: The email address of the person who is creating a new user profile in PagerDuty.


  • Type: The type of role that is assigned to the new user, either user or user_reference.

  • Name: The name of the new user.

  • Email: The user's email address.

  • Timezone: The timezone where the user resides.

  • Color: The user's schedule color. Each user has a color associated with their profile that's used in the on-call schedule for faster recognition.

  • Role: The user's role. A role can be admin, limited_user, observer, owner, read_only_user, restricted_access, read_only_limited_user, or user.

Note: A user be assigned the read_only_users role to be able to set a user as read_only_user or read_only_limited_user. A user must be assigned the permissions_service role to be able to set a user as observer or restricted_access.

  • Job Title: The user's job title.

  • URL: The URL for the user's avatar.

  • Description: The user's biographical information for their account.

  • Password: The user's account password.


User ID: The unique identifier for the new user profile generated by your PagerDuty instance.

Related topics