From 168532bbe241bb79ea784c1874345421d200015d Mon Sep 17 00:00:00 2001 From: mihaisau-snyk Date: Fri, 11 Sep 2026 16:34:52 +0300 Subject: [PATCH] DOCT-1903: clarify PAT type and add Billing Admin guidance for Snyk Essentials GitHub setup --- .../github-for-snyk-essentials.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/developer-tools/scm-integrations/group-level-integrations/github-for-snyk-essentials.md b/developer-tools/scm-integrations/group-level-integrations/github-for-snyk-essentials.md index 7a1ab25ef2aa..b160f662a326 100644 --- a/developer-tools/scm-integrations/group-level-integrations/github-for-snyk-essentials.md +++ b/developer-tools/scm-integrations/group-level-integrations/github-for-snyk-essentials.md @@ -15,12 +15,14 @@ If you used GitHub Apps for your SCM integrations at the Snyk Organization level * Builds - only when using GitHub Actions. * Scans - only when using Code security. -Ensure you meet all prerequisites listed on the [GitHub and GitHub Enterprise permission requirements](../user-permissions-and-access-scopes.md#github-and-github-enterprise-permissions-requirements) page. +Ensure you meet all prerequisites listed on the [GitHub for Snyk Essentials permission requirements](../user-permissions-and-access-scopes.md#github-for-snyk-essentials) page. To configure a Group-level integration, you must be a Group Admin or have a custom role that includes the `Edit Snyk Essentials` permissions under the [Group-level permissions](https://app.gitbook.com/s/IgtgtomLQ2TUgSKOMSAm/user-management/pre-defined-roles#group-level-permissions). ## Integrate GitHub using Snyk Essentials: +Snyk Essentials Group-level GitHub integrations use a classic personal access token (PAT), not a fine-grained PAT. + 1. Profile name (`mandatory`): Input your integration profile name. 2. Organizations (`mandatory`): Input the names of all the relevant GitHub organizations. @@ -48,6 +50,10 @@ If you want to pull data from both organization and personal repositories, then ## Generate a Personal access token from your GitHub settings +{% hint style="info" %} +Generate the PAT from a GitHub Billing Admin account. This helps ensure Snyk Essentials can access all downstream organizations in the account and reduces the risk of the token becoming invalid when an individual user leaves the organization. +{% endhint %} + 1. Open GitHub and click the Settings menu for your profile. 2. Select Developer settings from the left sidebar. 3. Select Personal access tokens and then Tokens (classic).