> ## Documentation Index
> Fetch the complete documentation index at: https://docs.collabase.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Manage issues, pull requests, releases, and trigger GitHub Actions workflows.

# GitHub

Integrate Collabase automations with GitHub repositories — create and update issues, comment on pull requests, trigger CI/CD workflows, create releases, and react to push and release events.

## Authentication

**Auth type:** Personal Access Token

Generate a token at [github.com/settings/tokens](https://github.com/settings/tokens). Grant `repo` scope for private repositories, `public_repo` for public only.

| Credential | Description                                    |
| ---------- | ---------------------------------------------- |
| **Token**  | GitHub personal access token with `repo` scope |

## Triggers

| Trigger                 | When it fires                    |
| ----------------------- | -------------------------------- |
| **Push**                | A commit is pushed to any branch |
| **Pull Request Opened** | A new pull request is opened     |
| **Pull Request Merged** | A pull request is merged         |
| **Issue Opened**        | A new issue is created           |
| **Issue Closed**        | An issue is closed               |
| **Release Published**   | A new release is published       |

<Note>
  Configure a webhook in your GitHub repository under **Settings → Webhooks**, pointing to your Collabase webhook endpoint, to enable triggers.
</Note>

## Actions

| Action                | Key inputs                                                           | Key outputs                                                |
| --------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------- |
| **Create Issue**      | `owner`, `repo`, `title`, `body`, `labels[]`, `assignees[]`          | number, html\_url, state                                   |
| **Update Issue**      | `owner`, `repo`, `issueNumber`, `title`, `body`, `state`, `labels[]` | number, html\_url                                          |
| **Close Issue**       | `owner`, `repo`, `issueNumber`                                       | number, state                                              |
| **Add Issue Comment** | `owner`, `repo`, `issueNumber`, `body`                               | id, html\_url                                              |
| **Trigger Workflow**  | `owner`, `repo`, `workflowId`, `ref`, `inputs{}`                     | dispatched                                                 |
| **Create Release**    | `owner`, `repo`, `tagName`, `name`, `body`, `draft`, `prerelease`    | id, html\_url, tagName                                     |
| **Get Repository**    | `owner`, `repo`                                                      | name, full\_name, description, stars, forks, defaultBranch |

<Tip>
  **Trigger Workflow** dispatches a `workflow_dispatch` event. The target workflow file must have `on: workflow_dispatch` in its triggers.
</Tip>