GitHub

What you can do #

Use GitHub to capture an idea as an issue, read an issue’s current state, or get details about a repository. A repository is the project that owns the code and issues. An owner is its GitHub user or organization.

GitHub uses Shortcutify’s standard editor. You choose an action, then open each named input to fill it in. This guide starts with creating an issue; the action list below covers the other supported operations.

Connect GitHub #

1. Open GitHub’s fine-grained personal access token settings and create a token.
2. Choose the repository owner and repositories it should reach. Grant the permissions needed by your action. Creating an issue needs Issues: write; reading issues needs read access.
3. Create and copy the token. In Shortcutify, open Services → GitHub, paste it into Paste your token, and tap Connect GitHub.

A token is a credential the app uses on your behalf. GitHub’s repository, organization, expiration, and approval rules still apply. Each action reference below lists the permissions declared by Shortcutify. GitHub’s token guide explains the permission settings.

Example: save a quick note as an issue #

1. In Actions, tap +, choose GitHub, then Create an Issue.
2. Fill in Owner with the GitHub user or organization, and Repository with the repository’s name. Keep both saved as text.
3. Open Title, choose Shortcuts as its source, and select Param 1. The optional Body input can hold a longer note.
4. Name and save the action. In Apple Shortcuts, add Execute Action, choose it, and pass your note’s title through Param 1.

To use the new issue’s link in the next Shortcuts step, open Returned Value in the action editor and select the response’s html_url field.

Test with a title you want to keep

Running this action creates a real GitHub issue. It is useful to test it in a repository where you can keep or close the example issue.

If something does not work #

All GitHub actions #

These are the actions available in the app’s request picker. Open one for its inputs, returned fields, and permissions.

Service setup references #

The service controls its account requirements and permissions. These references explain its setup in more detail.

• Personal access tokens
• GitHub REST API