Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Set up the GitHub spoke

Integrate your ServiceNow instance with the GitHub and GitHub Enterprise Server to automate flows and perform actions on GitHub and GitHub Enterprise Server. For example, create a flow that creates a branch on GitHub and retrieves its details.

[Omitted video] Description: Demonstrates integrating the ServiceNow instance with GitHub and GitHub Enterprise Server.

Before you begin

  • Request an Integration Hub subscription.
  • Activate the GitHub spoke.
  • An account with GitHub to create personal access tokens.
  • If you are using GitHub Enterprise server, an account to create personal access tokens.
  • Role required: admin.

Procedure

  1. Generate a personal access token in GitHub account.

    1. Log in to https://github.com/.

    2. On the dashboard, select your profile icon.

Image omitted: github-spoke-profile-icon.png
GitHub profile icon.
3.  Select **Settings**.

4.  In the Settings page, on the left panel, select **Developer settings**.

5.  In the Developer settings page, on the left panel, navigate to **Personal access tokens** > **Tokens \(classic\)**.

6.  Select **Generate new token** > **Generate new token \(classic\)**.

7.  In **Note**, enter a description or purpose of the personal access token.

8.  In **Expiration**, set the expiry period of the token or select No expiration.

9.  Under the **Select scopes** heading, select the scopes that define the access for the personal access token you’re generating.

10. Select **Generate token**.

    The personal access token is generated.

11. To copy the personal access token, select the copy button.
Image omitted: github-spoke-copy-token-button.png
Personal access token copy button.
    **Important:** Keep the personal access token at a secure place. You’ll need it when you create a connection record for GitHub.
  1. Configure the connection record that connects your ServiceNow instance with GitHub.

    1. Log in to your ServiceNow.

    2. Navigate to All > Process Automation > Workflow Studio.

    3. Click the Integrations tab.

    4. Under Connections, toggle and enable the Outbound connections.

    5. Locate the GitHub connection alias and click View Details.

      If you are configuring the spoke for the first time, click Configure. Otherwise, click Edit.

    6. On the form, fill the details.

FieldDescription
Connection NameName of the connection. Note: The default and read-only name of the first connection record is GitHub.
Connection URLURL to connect to GitHub. Enter https://api.github.com.
Use Mid Server
  • Enter 1 if your ServiceNow instance requires a MID Server to connect with GitHub.
  • Enter 0 if your ServiceNow instance does not require a MID Server to connect with GitHub. Important: To enable this option, you must already have a MID Server set up on your instance. See MID Server for detailed instructions.
API KeyPersonal access token that you had generated on GitHub.
7.  Select **Create Connection**.

    The GitHub connection record is created.
  1. If you are using GitHub Enterprise server, configure the GitHub Server connection.

    Important: Generate a personal access token on the GitHub Enterprise server.

    To learn to generate a personal access token on the GitHub Enterprise server, see .

    1. Select the GitHub Server connection card.

    2. Select View Details.

    3. Fill the form.

FieldDescription
Connection NameThe name of the connection. Note: The default and read-only name of the first connection record is GitHub Server. To create a connection with your custom name, select Add Connection and fill the form.
Connection URLURL of your GitHub instance.
Use Mid Server
  • Enter 1 if your ServiceNow instance requires a MID Server to connect with the GitHub Enterprise server.
  • Enter 0 if your ServiceNow instance does not require a MID Server to connect with the GitHub Enterprise server. Important: To enable this option, you must already have a MID Server set up on your instance. See MID Server for detailed instructions.
API KeyPersonal access token that you had generated on the GitHub Enterprise Server.
4.  Select **Create Connection**.

    The GitHub Enterprise Server connection record is configured.