--- sourceDocument: Australia IT Service Management sourceDocumentLink: https://www.servicenow.com/docs/r/it-service-management Release : - australia ft:locale : - en-US ft:publication_title : - Australia IT Service Management ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # GitHub # GitHub integration with DevOps Change Velocity {#ariaid-title1} * Release version: Australia * * Updated March 12, 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of GitHub Integration with DevOps Change Velocity The GitHub integration with DevOps Change Velocity enables users to connect their GitHub instances for effective change traceability and automation. It supports Plan, Code, and Orchestration capabilities across both GitHub and GitHub Enterprise, allowing for the discovery of repositories, plans, and pipeline definitions. Show full answer Show less ## Key Features * **Connect:** Discover repositories and configure pipelines by linking your GitHub instance to DevOps Change Velocity. * **Configure Notifications:** Enable real-time notifications for commits, work items, and pipelines through automated Webhooks in GitHub, facilitating the creation of change policies. * **Permission Requirements:** Base permissions of Read and Admin are necessary for discovering and configuring repositories within an organization. * **Authentication Methods:** Options include Basic authentication and OAuth 2.0, allowing the use of custom actions from the GitHub marketplace and workflow secrets. * **Custom Actions:** ServiceNow provides custom actions in the GitHub Marketplace for orchestration, enabling interaction with workflows. ## Key Outcomes By integrating GitHub with DevOps Change Velocity, customers can enhance their change management processes, automate notifications, and streamline the workflow management experience. The integration supports a structured onboarding process through the workspace, Service Catalog, or Classic experience, ensuring that users can efficiently configure and manage their GitHub resources. Connect to your GitHub instance to discover repositories, plans, pipeline definitions and configure real-time notifications or polling to enable change traceability and automation. ## GitHub integration overview {#github-integration-dev-ops__section_kqt_3fr_2wb} DevOps Change Velocity supports Plan (Plans), Code (Repository) and Orchestration (Actions) capabilities for the GitHub tool. Both GitHub and GitHub Enterprise are supported. The following operations are performed as part of integrating GitHub: * Connect: Discover repositories, plans, and pipeline definitions by connecting your GitHub instances to DevOps Change Velocity. * Configure: Enable sending real-time notifications for commits, work items, and pipelines by automatically creating a Webhook (push, issues, and workflow_job) in GitHub so that this data can be used to create change policies. {#github-integration-dev-ops__ul_kdn_2vq_2wb} Repositories under an organization can also be discovered and configured if you have the following base permissions for the organization (member privileges): * Discover: Base permission of Read. * Configure: Base permission of Admin. {#github-integration-dev-ops__ul_rls_vl2_xyb}If Base permissions is specified as No permission for an organization, repositories under that organization can't be discovered even if they're public. The owner of an organization can either select all repositories or specific repositories for an organization and only the selected repositories are discovered. Even if a repository is public, it can't be discovered unless the owner selects it for an organization. For repositories under an organization, you must not have the same repository configured in more than one tool on an instance. If the same repository is configured for multiple tools, then data is associated with a random tool as part of notifications events. If you want to configure the same repository in a different tool, you must delete the webhooks created from the first tool, untrack the repository under that tool, and then configure the same repository in the different tool. ## Authentication methods {#github-integration-dev-ops__section_zkw_rrg_myb} You can connect to GitHub using one of the following authentication methods: * Basic authenticationIf you connect your GitHub instance with basic auth, you can use the custom actions from the GitHub marketplace. GitHub environments aren't supported for basic auth connection. * [OAuth 2.0 credentials](https://www.servicenow.com/docs/HjQo367R5VqHjdv2Z2CANQ "Create OAuth 2.0 credentials for GitHub Apps or OAuth apps and use them to connect your GitHub instance.") * If you connect your GitHub instance with OAuth 2.0 credentials for Authorization code, you can use the custom actions from the GitHub marketplace and create secrets to use in workflows. For more information, see [OAuth 2.0 credentials for GitHub Apps - Authorization Code](https://www.servicenow.com/docs/iNOBdrAgK2OG~78uSWlmyw#dev-ops-github-apps-oauth-auth "Perform the following steps to integrate your GitHub Apps using Authorization code."). * If you connect your GitHub instance with OAuth 2.0 credentials for GitHub Apps - JWT, you can use the custom actions from the GitHub marketplace, create secrets to use in workflows, and GitHub environments to deploy to an environment. For more information, see [OAuth 2.0 credentials for GitHub Apps - JWT](https://www.servicenow.com/docs/pYj7RzmHaIyI3F~v8Dkv6Q#dev-ops-github-apps-oath-jwt "Perform the following steps to integrate your GitHub Apps using the JWT bearer token."). For GitHub repositories under an organization, only one organization can be installed per tool (i.e - One GitHub App can be installed with One GitHub Org and with One GitHub tool). If you want to add more organizations, you can create separate tools and apps. {#github-integration-dev-ops__ul_tzf_wwn_ryb} {#github-integration-dev-ops__ul_xgm_2j3_smb} Note: The OAuth Authorization Code \& JWT grant types are supported for GitHub \& GitHub Enterprise with MID server. Custom actions by ServiceNow are available in GitHub Marketplace for the orchestration capability, to push information from Actions (workflows) and to pause or resume workflows from DevOps Change Velocity. For more information on custom actions, see [ServiceNow DevOps custom actions from GitHub marketplace](https://www.servicenow.com/docs/8IIHLttsKDPIeqy0xNUBZg#servicenow-devops-custom-actions-from-github-marketplace "Use the custom actions from the GitHub marketplace to collect SonarQube scan data, security data, pause or resume workflow, or resume workflow until a change request is approved or rejected in your instance, or get and update change request details and so on."). To capture the workflow data in DevOps Change Velocity, you must configure Secrets in your GitHub tool. For more information, see [GitHub Actions configurations](https://www.servicenow.com/docs/SJMWwYdcFPKTKX8bsB7GNg#github-actions-integration-with-devops "Configuration information on GitHub Actions, such as, secrets, workflows, and limitations."). There are a few limitations for GitHub Actions support, see [GitHub Actions configurations](https://www.servicenow.com/docs/SJMWwYdcFPKTKX8bsB7GNg#github-actions-integration-with-devops "Configuration information on GitHub Actions, such as, secrets, workflows, and limitations."). ## Get started {#github-integration-dev-ops__section_xqj_wrz_gwb} Use one of the following options to onboard GitHub. For a guided experience, use the workspace to onboard a tool. Alternatively, you can use the Service Catalog or Classic experience. * **[Onboard GitHub to DevOps Change Velocity --- Workspace](https://www.servicenow.com/docs/Cm6t89d6TJG5LRAHb5GaMw)** Connect to your GitHub instance using the DevOps Change Workspace playbook to discover, configure, and import repositories, plans, and pipelines. * **[Onboard GitHub to DevOps Change Velocity --- Service Catalog](https://www.servicenow.com/docs/kER61tkfr~LQgvMYTqHDlw)** Create, connect, discover, and configure your GitHub instance using the ServiceNow Service Catalog. * **[Onboard GitHub to DevOps Change Velocity --- Classic](https://www.servicenow.com/docs/bns4cAWLlDd0DHdE0bJ3kQ)** Connect your GitHub instance to discover, configure, and import repositories, plans, and pipelines.