Skip to main content

Authenticate your GitHub account

In order to use the GitHub API, you'll need to authenticate with an OAuth App

1. Create a new authentication in Meta API​

Log in on Meta API dashboard and go to the API's Authentication page. Click on the Create a new authentication button and select the GitHub API. Generate your personal link and copy it, and then click on Save.

Step 1

2. Create a GitHub App​

Register new GitHub App on your GitHub account settings.

Choose a name, fill your homepage URL (if you don't have one, it will work with anything) and the Callback URL you just copied.

Step 2.1

User-to-server token are a beta feature on GitHub and might not work correctly

Make sure to uncheck the Expire user authorization tokens checkbox when you configure your app or Opt-out from the Optional features

Step 2.5

Uncheck the Webhook activation Step 2.2

Select the permissions that you'll need in your Spells (you can update your App later to add more). For example: request Read & write access for Contents to view and update files Step 2.3

Finally, choose if only your private account will use this app or if you plan to use it with an organization account or other GitHub users. Step 2.4

3. Update the Meta API authentication​

Copy the Client ID and the Client secret (you'll have to generate one) and past them on the authentication modal in Meta API.

Step 3.1

Select the permissions you need and set the scope delimiter with just a space (" ").

Step 3.2

Install the App in your GitHub account (or organization) and select the repositories you need to access

Step 3.3

4. Authorize your account​

Click on the Authorize button, the GitHub popup will open and ask you to authorize it.

Step 4.1

Reload the page to see your OAuth profile. Step 4.2

5. Use your OAuth profile in a Spell​

Step 5