Owner
RequiredTextUser or organisation.
This input offers a picker for repository from your connected account. You can also supply its value directly.
Example value (replace with your own):
octocat
In this guide
Create an Issue
Open a new issue.
What this action does #
First, connect GitHub in Services. Then open Actions → + → GitHub and choose Create an Issue.
What a run does
Running or testing this action creates something in your connected service.
More about this action
Title is all GitHub insists on, which is what makes this the best action in the catalog to drive from dictation or a share sheet. Body is Markdown.
Labels and assignees must already exist: a label that does not exist in the repository is created silently, but an assignee who is not a collaborator is dropped without an error, so an issue can come back assigned to nobody.
If issues are turned off for the repository the answer is 410, not 404. Creating many issues in quick succession trips a secondary rate limit that no amount of retrying fixes — space them out.
Inputs to fill in #
Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.
Repository
RequiredTextName only, without the owner and without .git.
This input offers a picker for repository from your connected account. You can also supply its value directly.
Example value (replace with your own):
Hello-World
Title
RequiredTextOne line. Shown everywhere the issue is.
Example value (replace with your own):
Crash when opening Logs
Body
OptionalTextThe issue text, as Markdown.
Example value (replace with your own):
Steps to reproduce:
Labels
OptionalListLabel names. Comma-separated.
A list of text values. Use a comma-separated list.
This input offers a picker for label from your connected account. You can also supply its value directly.
Example value (replace with your own):
bug
Assignees
OptionalListUsernames. They must have access to the repository.
A list of text values. Use a comma-separated list.
This input offers a picker for person from your connected account. You can also supply its value directly.
Example value (replace with your own):
octocat
Milestone
OptionalWhole numberMilestone number, not its title.
This input offers a picker for milestone from your connected account. You can also supply its value directly.
What comes back #
In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.
| Returned field | Type | Meaning |
|---|---|---|
number | integer | The issue number shown in the UI. |
id | integer | Internal id. Not the number. |
title | string | Text value. |
state | string | open or closed. |
state_reason | string | completed, not_planned, reopened or duplicate. |
body | string | The issue text, as Markdown. |
html_url | string | The issue page. |
comments | integer | How many comments it has. |
locked | boolean | True or false. |
created_at | string | ISO 8601. |
updated_at | string | Text value. |
closed_at | string | Null while open. |
user | object | Who opened it. |
user.login | string | Username. |
user.id | integer | Whole-number value. |
user.html_url | string | Their profile page. |
user.avatar_url | string | Text value. |
user.type | string | User, Organization or Bot. |
assignees | array | Everyone assigned. |
assignees[].login | string | Username. |
assignees[].id | integer | Whole-number value. |
assignees[].html_url | string | Their profile page. |
assignees[].avatar_url | string | Text value. |
assignees[].type | string | User, Organization or Bot. |
milestone | object | Null when unset. |
milestone.number | integer | Whole-number value. |
milestone.title | string | Text value. |
milestone.due_on | string | Text value. |
labels | array | Each entry is either an object or a plain string. |
labels[].name | string | Text value. |
labels[].color | string | Six hex digits, no leading #. |
labels[].description | string | Text value. |
pull_request | object | Present only when the issue is a pull request. |
pull_request.html_url | string | Text value. |
pull_request.merged_at | string | Null unless it was merged. |
Run it from Shortcuts #
- Give the action a recognizable name and tap Save.
- In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
- Supply any Param or File slots you bound in the inputs, then run the shortcut.
If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.
Advanced reference #
Request, permissions, and identifiers
Request: POST https://api.github.com/repos/{owner}/{repo}/issues
Action identifier: github.issues.create.v1
Permissions declared for this action: issues:write. The account’s own access rules also apply.
| Input | Request key | Location |
|---|---|---|
| Owner | owner | path |
| Repository | repo | path |
| Title | title | body |
| Body | body | body |
| Labels | labels | body |
| Assignees | assignees | body |
| Milestone | milestone | body |