In this guide

Create a Pull Request

Open a pull request from one branch into another.

Action referenceCreate

What this action does #

First, connect GitHub in Services. Then open Actions → + → GitHub and choose Create a Pull Request.

What a run does

Running or testing this action creates something in your connected service.

More about this action

Both branches must already exist and must differ; GitHub answers 422 with "No commits between base and head" when they do not.

Head is a plain branch name for a branch in the same repository, and `owner:branch` when the source is a fork. Draft cannot be changed afterwards through this API — marking a pull request ready for review is a GraphQL-only operation.

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.

Owner

RequiredText

User 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

Repository

RequiredText

Name 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

RequiredText

Supply a text value for this input.

Example value (replace with your own):

Add login screen

From Branch

RequiredText

Source branch, or owner:branch from a fork.

This input offers a picker for branch from your connected account. You can also supply its value directly.

Example value (replace with your own):

feature-login

Into Branch

RequiredText

Target branch in this repository.

This input offers a picker for branch from your connected account. You can also supply its value directly.

Example value (replace with your own):

main

Description

OptionalText

Markdown.

Draft

OptionalOn or off

Opens it as a draft. Cannot be undone through the REST API.

Maintainers Can Edit

OptionalOn or off

Only meaningful when the source is a fork.

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 number shown in the UI.
`id`	integer	Whole-number value.
`title`	string	Text value.
`state`	string	open or closed. A merged pull request is closed.
`draft`	boolean	True or false.
`merged_at`	string	Null unless it was merged — the way to tell merged from simply closed.
`body`	string	The description, as Markdown.
`html_url`	string	The pull request page.
`created_at`	string	ISO 8601.
`updated_at`	string	Text value.
`closed_at`	string	Text value.
`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	A list of values.
`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.
`requested_reviewers`	array	Review requests still outstanding.
`requested_reviewers[].login`	string	Username.
`requested_reviewers[].id`	integer	Whole-number value.
`requested_reviewers[].html_url`	string	Their profile page.
`requested_reviewers[].avatar_url`	string	Text value.
`requested_reviewers[].type`	string	User, Organization or Bot.
`labels`	array	A list of values.
`labels[].name`	string	Text value.
`labels[].color`	string	Text value.
`head`	object	Where the changes come from.
`head.ref`	string	Branch name.
`head.sha`	string	Latest commit on that branch.
`head.label`	string	owner:branch.
`base`	object	Where they are going.
`base.ref`	string	Branch name.
`base.sha`	string	Text value.

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}/pulls

Action identifier: github.pulls.create.v1

Permissions declared for this action: pull_requests:write. The account’s own access rules also apply.

Input	Request key	Location
Owner	`owner`	path
Repository	`repo`	path
Title	`title`	body
From Branch	`head`	body
Into Branch	`base`	body
Description	`body`	body
Draft	`draft`	body
Maintainers Can Edit	`maintainer_can_modify`	body

GitHub API reference