{"_id":"5d26438f38d460003ea9e8bf","project":"564e5930c3553e0d003e53d0","version":{"_id":"564e5a9b1560880d008d30dc","project":"564e5930c3553e0d003e53d0","__v":27,"createdAt":"2015-11-19T23:26:19.166Z","releaseDate":"2015-11-19T23:26:19.166Z","categories":["564e5a9b1560880d008d30dd","566318e1f5ca460d00f41896","56631d08cd54d50d005015fa","56631d2a81ad7417006a202c","5668ba19fbd7680d009375f4","5668cb8b10bda80d00797ed9","5668cb9d10bda80d00797eda","56830d8a3f94e00d004e2a7a","56830d9072bb720d0091f594","56830d94cb4d190d0027698e","56830dc44aecbd0d00a464c5","569e90f3c9b43e0d00c4bab1","56a96d338791090d00113bab","56b12d8336d2580d00247877","56c36bf0a869d017002ea55b","56c36bf93d30210d00ea84bb","56c77749b935671700ff0304","56c7ab9e5652c217008e091a","56cb8bdad5c6241d00ef5e61","58aefce02470660f00b54539","58aefd0bebd7370f0078b954","59ca65ca4337830026edf24f","5c33cd9eb47ba20051ac8d64","5c33df728bec1d0063431c34","5c4783ef523219027055513a","5c4f35033400f3010203a999","5d1d0c9f19c3a0003aeb525a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Foundation","version_clean":"2.0.0","version":"2"},"category":{"_id":"5d1d0c9f19c3a0003aeb525a","project":"564e5930c3553e0d003e53d0","version":"564e5a9b1560880d008d30dc","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2019-07-03T20:14:23.802Z","from_sync":false,"order":2,"slug":"app-integration-development","title":"App / Integration Development"},"user":"5bbfe5dfe752030003c5cb52","__v":0,"parentDoc":null,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-07-10T19:59:11.520Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"# Accessing Developer Mode\nWhen you log into a developer account, you'll be taken straight to Developer Mode. If you're on a PagerDuty customer account, follow these steps:\n\n1. Log in to your PagerDuty account.\n2. From the top menu, select the ![icon](https://files.readme.io/67e682a-app_icon.png) icon to the left of the profile picture.\n3. Select **Developer Mode** from the menu to navigate to the **My Apps** page.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a5a3f82-dev_mode.png\",\n        \"dev_mode.png\",\n        1056,\n        320,\n        \"#f3f3f3\"\n      ]\n    }\n  ]\n}\n[/block]\n# Creating an app\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Apps are associated with a PagerDuty subdomain and a user and cannot be moved between subdomains or users. Continued access to this subdomain and user is needed to make any configuration changes to the app.\",\n  \"title\": \"\"\n}\n[/block]\n1. On the **My Apps** page in **Developer Mode**, select **Create New App**.\n2. Enter the **App Name** and **Brief Description**. Then select up to 3 categories from the **Category** selection menu. All of this information can be changed later.\n3. Select whether or not you intend to publish your app for all PagerDuty users. This is optional, for information purposes only, and you can change your answer later.\n4. Click **Save**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/29f007e-app_register.png\",\n        \"app_register.png\",\n        1356,\n        1250,\n        \"#d6d8da\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n# Editing your app configuration\n\nOnce you've registered an app, it will appear on your **My Apps** page in Developer Mode. Select an app to be taken to it's configuration page where you can edit any of the details you have already entered and add more:\n\n* *Optional*: provide an **App Website URL** where users can learn more about the app.\n* *Optional*: provide the **Icon URL**, a link to a hosted image file that will display with the app. Icons should be sized 50px by 50px. Once the image link is input, the image will display to the side and in the **Preview** box.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/86c514e-app-preview-box.png\",\n        \"app-preview-box.png\",\n        659,\n        162,\n        \"#dcdcdc\"\n      ]\n    }\n  ]\n}\n[/block]\nChanges to your app will not be saved until you click **Save** at the bottom of the page. You should get a confirmation that your app was saved.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/aef3435-app-save-successful.png\",\n        \"app-save-successful.png\",\n        652,\n        135,\n        \"#d2e3da\"\n      ]\n    }\n  ]\n}\n[/block]\nCongratulations! You have successfully registered your app. \n\nNext, learn how you can [connect your app to PagerDuty](https://v2.developer.pagerduty.com/docs/connect-an-app-to-pagerduty) to send and receive data.","excerpt":"","slug":"how-to-build-an-app","type":"basic","title":"Register an App"}
# Accessing Developer Mode When you log into a developer account, you'll be taken straight to Developer Mode. If you're on a PagerDuty customer account, follow these steps: 1. Log in to your PagerDuty account. 2. From the top menu, select the ![icon](https://files.readme.io/67e682a-app_icon.png) icon to the left of the profile picture. 3. Select **Developer Mode** from the menu to navigate to the **My Apps** page. [block:image] { "images": [ { "image": [ "https://files.readme.io/a5a3f82-dev_mode.png", "dev_mode.png", 1056, 320, "#f3f3f3" ] } ] } [/block] # Creating an app [block:callout] { "type": "info", "body": "Apps are associated with a PagerDuty subdomain and a user and cannot be moved between subdomains or users. Continued access to this subdomain and user is needed to make any configuration changes to the app.", "title": "" } [/block] 1. On the **My Apps** page in **Developer Mode**, select **Create New App**. 2. Enter the **App Name** and **Brief Description**. Then select up to 3 categories from the **Category** selection menu. All of this information can be changed later. 3. Select whether or not you intend to publish your app for all PagerDuty users. This is optional, for information purposes only, and you can change your answer later. 4. Click **Save**. [block:image] { "images": [ { "image": [ "https://files.readme.io/29f007e-app_register.png", "app_register.png", 1356, 1250, "#d6d8da" ], "sizing": "full" } ] } [/block] # Editing your app configuration Once you've registered an app, it will appear on your **My Apps** page in Developer Mode. Select an app to be taken to it's configuration page where you can edit any of the details you have already entered and add more: * *Optional*: provide an **App Website URL** where users can learn more about the app. * *Optional*: provide the **Icon URL**, a link to a hosted image file that will display with the app. Icons should be sized 50px by 50px. Once the image link is input, the image will display to the side and in the **Preview** box. [block:image] { "images": [ { "image": [ "https://files.readme.io/86c514e-app-preview-box.png", "app-preview-box.png", 659, 162, "#dcdcdc" ] } ] } [/block] Changes to your app will not be saved until you click **Save** at the bottom of the page. You should get a confirmation that your app was saved. [block:image] { "images": [ { "image": [ "https://files.readme.io/aef3435-app-save-successful.png", "app-save-successful.png", 652, 135, "#d2e3da" ] } ] } [/block] Congratulations! You have successfully registered your app. Next, learn how you can [connect your app to PagerDuty](https://v2.developer.pagerduty.com/docs/connect-an-app-to-pagerduty) to send and receive data.