From 445511769f57c6ab7ee4c3d5c5036c1250c56d38 Mon Sep 17 00:00:00 2001
From: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com>
Date: Fri, 5 Jan 2024 10:36:44 -0600
Subject: [PATCH] Update github-apps.md

Provide information on troubleshooting a specific error with GitHub Apps integration

Signed-off-by: Jake Taylor <147415933+jrtaylorJH@users.noreply.github.com>
---
 docs/integrations/github/github-apps.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/integrations/github/github-apps.md b/docs/integrations/github/github-apps.md
index cc84704799..495f789f7e 100644
--- a/docs/integrations/github/github-apps.md
+++ b/docs/integrations/github/github-apps.md
@@ -139,3 +139,13 @@ integration:
   - `Variables`: `Read & write` (if templates include GitHub Action Repository Variables)
   - `Secrets`: `Read & write` (if templates include GitHub Action Repository Secrets)
   - `Environments`: `Read & write` (if templates include GitHub Environments)
+
+  ### Troubleshooting
+
+  `HttpError: This endpoint requires you to be authenticated.`
+
+This message tends to wrap a `NotFoundError: No app installation found` under the hood, which
+is the reuslt of not installing the app in your organization. Even if created via the `backstage-cli`
+as a member and app manager of your organization, the app will not automatically install. You
+must posses the `Owner` role in the organization to see the `Install` menu under your
+app settings, then manually press `Install` to authorize the application.