Generating an API Key

Follow

Please follow the instructions below to generate an API Access Key. Note:  You must be an admin or account owner within PagerDuty to access your API key. Also, your plan has to be on at least the Basic plan; API access is not included on the Lite plan. 

Depending on the type of API key you are creating, for more information about authenticating using an API key, please consult the related documentation for v1 or v2.

Most integrations will require a v1 API key. For more information on the differences between the APIs, check out our article on What is the difference between the APIs?

  1. Go to the Configuration menu and select API Access.

  2. Click on + Create New API Key at the top right-hand corner of the page. 
  3. Enter a Description.

    This description is to help you identify the key later on and can not be changed, so we recommend choosing the name carefully. For example, if you want to give somebody temporary access to your account via the API, you can do so by giving them a key with their name as the description, then delete the key without breaking other using the API with different keys.

  4. Select the version of the API you will be using (v1 or v2), then click Create Key. Most integrations will require a v1 API key. For more information on the difference between v1 and v2, and which API key you should create, check out our article on the difference between v1 and v2 of the API. 
  5. A unique API key will be generated. Copy it to a safe place and click Close.

    Note: Once you click Close you will be asked to confirm that you copied the API key. This is your last chance to copy the key; you will only be able to see the last 4 character of the key in the PagerDuty interface after you confirm. If you lose a key you will need to delete it and create a new one.

  6. Once created, you will see your key appear in the list of keys on the API Access page, with versioning noted. 

Have more questions? Submit a request

Comments

  • Avatar
    Senthil Kumar

    Hi, I'm in "user" role and I sign in with pagerduty account. Do I have to admin to generate api key? Why the restriction?

  • Avatar
    Jonathan Curry

    Hi Senthil,

    Right now only admins and the account owner can create API keys because the API gives you admin-level access to the account. If there are specific API calls you would like to make as a user or limited user, please email support@pagerduty.com and we'll be happy to submit a feature request to our product team for you.

    Cheers,

    Jonathan

  • Avatar
    Priyata Singh

    It is documented very well. Just follow and do it and get the result. Good Work!!