GitHub

Interact with GitHub repositories, issues, and pull requests from your Spala flows.

GitHub

The GitHub addon connects your Spala flows to the GitHub API. Create issues, manage pull requests, query repositories, and build automations around your development workflow.

Installation

1. Enable the GitHub addon from the Addons panel
2. Create a personal access token or GitHub App token
3. Enter the token in the addon configuration

Configuration

Available Steps

Create Issue

Creates a new issue in a GitHub repository.

List Issues

Retrieves issues from a repository.

Create Comment

Adds a comment to an issue or pull request.

Example: Auto-Create Issue from Bug Report

// POST /api/bug-reports

// Step 1: Create Issue (GitHub addon)
// owner: 'my-org'
// repo: 'my-app'
// title: '[Bug] ' + input.title
// body: '**Reported by:** ' + vars.auth.email + '\n\n' + input.description + '\n\n**Steps to reproduce:**\n' + input.steps
// labels: ['bug', 'user-reported']
// Output → vars.issue

// Step 2: Database Query - Link report to issue
// INSERT INTO bug_reports (user_id, title, github_issue_number, github_issue_url)
// VALUES (vars.auth.userId, input.title, vars.issue.number, vars.issue.html_url)

// Step 3: Response
// { issueUrl: vars.issue.html_url }

Example: Deployment Tracker

// Event trigger: "deployment.completed"

// Step 1: Create Comment (GitHub addon)
// owner: 'my-org'
// repo: 'my-app'
// issueNumber: event.payload.prNumber
// body: '**Deployed to production** :rocket:\nVersion: ' + event.payload.version + '\nTime: ' + new Date().toISOString()

For personal access tokens, use fine-grained tokens with the minimum required permissions. For issue management, you need "Issues" read/write access for the specific repository.

GitHub personal access token or GitHub App installation token with the required scopes.
Repository owner (user or organization).
Repository name.
Issue title.
Issue body in Markdown format.
Array of label names to apply.
Array of GitHub usernames to assign.
Repository owner.
Repository name.
'open', 'closed', or 'all' (default: 'open').
Comma-separated list of label names to filter by.
Repository owner.
Repository name.
The issue or pull request number.
Comment body in Markdown.
[Bug]
Addons Overview
/addons
Browse available addons
Installing Addons
/addons/installing
Enable and configure addons in your project