Integrate Terraform Cloud with GitHub

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read
  • 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.
      Terraform CVS provider registration form
    6. Select Register application.
    7. Copy the client ID.
    8. Select Generate a new client secret and copy the generated Client Secret.
    9. Go back to the Terraform console where the Add a VCS provider page is open and paste both Client ID and Client Secret.
      Terraform VCS provider page
    10. Select Connect and continue.
    11. 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.

    12. 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.

    GitHub OAuth Token ID