Powered by Fivetran Quickstart Guide

This guide will show you how to build a data pipeline using our .

---

Prerequisites

• If you want to use your existing Fivetran account, you must be on a Standard Select, Standard, Enterprise, or Business Critical plan.

  NOTE: Alternatively, you can sign up for an account trial or .

• A

---

Setup instructions

1. (Optional) if you don't have a Fivetran account or want to create something from scratch.

   IMPORTANT: You may choose to use a new Fivetran account for this guide even if you already have a Fivetran account. In that case, use your browser in Incognito mode. This is required for the flow to not interfere with your existing Fivetran account.

2. (Optional) Create a by following the relevant destination setup guide instructions if you don't have one, or if you want to use a dedicated new destination for this guide. Alternatively, you can take the easy route with Partner Connect route recommended in the previous step.

3. if you don't have an API testing client. We also have the Fivetran Postman Collection for you to follow along with this guide.

   NOTE: Most substeps of the are transferable to curl or other API testing clients if you have other preferences.

4. .

5. .

6. .

7. In Fivetran, verify your data has been successfully synced to the destination.

Find your Destination Group ID

1. In your .
2. Select the destination you want to use.
3. On the Overview tab, make a note of the Destination Group ID. You will need it to create the GitHub connector.

Create GitHub connector and Connect Card

TIP: See our to learn more about Connect Cards.

1. In , go to Fivetran REST API > Connector Management > Create a Connector > Body.

   NOTE: If you chose to use a different API testing client, the actual navigation and command set may differ.

   

2. Delete the request body code block.

3. Enter the following content into the request body field:

   {
       "service": "github",
       "group_id": "",
       "config": {
          "schema": "",
          "pause_after_trial": true
       },
       "connect_card_config": {
          "redirect_uri": "https://fivetran.com",
          "hide_setup_guide": "true"
       }
   } 
   content_copy

   NOTE: The "pause_after_trial": true property will pause the connector after your trial ends.

4. For the "group_id" key value, enter the destination group ID you obtained in the step in double quotes.

5. For the "schema" key value, enter a schema name that must be unique per your destination. In schema names, you can use underscores _, letters, and digits.

6. Click Send.

7. Verify the connector has been successfully created, and the response body contains the following fields:

   "code": "Success",
   "message": "Connector has been created",
   content_copy

8. To test the Connect Card experience, scroll down to the "uri" key, then click the redirect link while holding the Command keyboard key.

9. Click Continue in the Connect Card displayed. You will be redirected to the connector setup form in Fivetran.

10. Select the authentication mode: OAuth or Personal Access Token.

    • If you choose OAuth, do the following:

      a. Click Authorize to authorize Fivetran to connect to your GitHub account. You will be redirected to GitHub.

      b. In GitHub, click authorize Fivetran and enter your password when prompted. You will be redirected to the connector setup form.

    • If you choose Personal Access Token, do the following:

      a. Create a .

      b. Enter the Username and Personal Access Token.

      c. Click Validate Personal Access Token.

11. Choose the Sync Specific Repositories sync mode.

12. Select a small repository with minimal history/interaction so that you don't need to wait too long for the connector to complete the initial sync.

    NOTE: If you choose a monorepo with tons of history, you will be waiting a while.

13. Click Save & Test. The setup tests start running.

14. Click Confirm. After the tests have passed, you are redirected to the Fivetran login page.

Verify successful initial sync in Fivetran

1. Log in to Fivetran.
2. You are redirected to the newly created GitHub connector page. On this page, you can verify the connector that you have successfully created using our REST API and authorized using the Connect Card has synced data to your destination.

You have just utilized our Connect Card to sync your GitHub data to your destination. Next step: You create an incredible application super-fast that utilizes Fivetran's pipelines programmatically. Talk to our today to get started.