---
title: "Start GitHub install"
method: POST
path: "/v1/connectors/github/install/start"
tags: ["GitHub"]
---

# Start GitHub install

`POST /v1/connectors/github/install/start`

Builds a GitHub App install redirect URL for the current organization.

## Request body

- object
  - `returnPath` string, required

## Response `200`

GitHub install redirect returned successfully.

- PluginArchGithubInstallStartResponse
  - `ok` true, required
  - `item` object, required
    - `redirectUrl` string, uri, required
    - `state` string, required

## Other responses

- `400` — The GitHub install request was invalid.
- `401` — The caller must be signed in to connect GitHub.
- `403` — The caller lacks permission to connect GitHub.

## Changes

- **2026-09-04** `d3984673ccd1` — 1 info
  - added the optional property `capability` to the response with the `400` status

[Change history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/connectors/github/install/start/post.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) · [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openworklabs/den-api/revisions/d3984673ccd1/schema)