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
Generate a personal access token in GitHub account.
Log in to https://github.com/.
On the dashboard, select your profile icon.
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.
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.
Configure the connection record that connects your ServiceNow instance with GitHub.
Log in to your ServiceNow.
Navigate to All > Process Automation > Workflow Studio.
Click the Integrations tab.
Under Connections, toggle and enable the Outbound connections.
Locate the GitHub connection alias and click View Details.
If you are configuring the spoke for the first time, click Configure. Otherwise, click Edit.
On the form, fill the details.
| Field | Description |
|---|---|
| Connection Name | Name of the connection. Note: The default and read-only name of the first connection record is GitHub. |
| Connection URL | URL to connect to GitHub. Enter https://api.github.com. |
| Use Mid Server |
|
| API Key | Personal access token that you had generated on GitHub. |
7. Select **Create Connection**.
The GitHub connection record is created.
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 .
Select the GitHub Server connection card.
Select View Details.
Fill the form.
| Field | Description |
|---|---|
| Connection Name | The 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 URL | URL of your GitHub instance. |
| Use Mid Server |
|
| API Key | Personal access token that you had generated on the GitHub Enterprise Server. |
4. Select **Create Connection**.
The GitHub Enterprise Server connection record is configured.