GitHub is a software development service for hosting and version control.

Torq enables quick and easy integration with GitHub, so you can automate anything and everything within moments. Torq's public GitHub steps include:

Get Issue
Get File
Run GraphQL query
List Repositories
+30 more...

If you don't see a step you need, you can create your own in various ways, such as using the Send an HTTP Request step or Torq’s Step Builder, and share it across your organization.

To trigger a Torq workflow based on events sent from GitHub, look here.

To use GitHub steps in Torq workflows, look here.

Use GitHub to Trigger Workflows in Torq

Step One: Create a GitHub Trigger Integration in Torq

Add the Integration: Go to Build > Integrations > Triggers > GitHub and click Add Instance.
Name the Integration: Give the integration a unique and meaningful name.
(Optional) Add an Authentication Header: Click Add.
1. Enter a name.
2. Click Generate Random Secret or enter your own.
3. Click Copy Secret to save it for later.
Finalize: Click Add and Copy the generated endpoint. You will need the URL for the webhook.

Step Two: Generate a Webhook in GitHub

Open Github: Navigate to Settings > Developer settings.
Create a GitHub App: Click New GitHub App, enter your password, and then click Confirm to confirm access to your account.
Register the GitHub App:
1. Name: Enter a meaningful name.
2. Homepage URL: Enter https://app.torq.io/.
3. Webhook URL: Paste the Torq endpoint you generated earlier.
Finalize: Click Create GitHub App.

Now that you've successfully created a GitHub trigger, you can build your first GitHub-initiated workflow!

In Torq, go to Build > Workflows > Create a Workflow > New Blank Workflow, and select the trigger type: Integrations > GitHub. Find your new trigger, and automate away!

Use GitHub Steps in a Torq Workflow

Step One: Generate a GitHub API Key

Open Github: Navigate to Settings > Developer settings > GitHub Apps and select the app you created earlier.
Create a Secret: Select the General tab and click Generate a new client secret in the Client secrets section.
Finalize: Copy the client secret to save it for later.

Step Two: Create a GitHub Steps Integration in Torq

Navigate to the Integration: Go to Build > Integrations > Steps > GitHub and click Add Instance.
Configure the Integration:
1. Give the integration a unique and meaningful name.
2. Paste the GitHub secret that you copied earlier.
Finalize: Click Add.

Templates

Now that you've added your integrations, check out these specially crafted templates by Torq's security experts. Visit Torq's template library for more.