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

Integrate Terraform Cloud with GitHub

Integrate GitHub with Terraform to link workspaces to repositories, enabling version control, change tracking, and rollbacks.

Before you begin

Role required: Terraform admin or DevOps team member

Procedure

  1. Go to the Terraform org created for this application.

  2. Navigate to Settings > Providers.

  3. Select Add a VCS provider.

  4. From the GitHub drop-down list, choose a GitHub.com (Custom).

  5. Select the link Register a new OAuth Application.

Image omitted: register-oauth.png
Terraform CVS provider registration form
  1. Select Register application.

  2. Copy the client ID.

  3. Select Generate a new client secret and copy the generated Client Secret.

  4. Go back to the Terraform console where the Add a VCS provider page is open and paste both Client ID and Client Secret.

Image omitted: terraform-vcs-form.png
Terraform VCS provider page
  1. Select Connect and continue.

  2. Select Authorize.

    Note: Follow the platform-specific instructions to authorize Terraform Cloud to access your GitHub repository.

    For more details, see the official documentation: https://developer.hashicorp.com/terraform/cloud-docs/vcs/Github-enterprise.

  3. On the Advance Settings page, select Skip and finish.

What to do next

Make a note of the OAuth Token ID and share it with the ServiceNow admin.

Image omitted: git-oauth-token.png
GitHub OAuth Token ID

Parent Topic:Setting up Terraform and GitHub

Related topics

Publish Terraform templates

Create a Terraform organization for Cloud Account Management in Cloud Workspace

Create Terraform API token