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.
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?.
Go to the Configuration menu and select API Access.
- Click on + Create New API Key at the top right-hand corner of the page.
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.
- 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.
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.
Once created, you will see your key appear in the list of keys on the API Access page, with versioning noted.