backlog-pr-link-action

GitHub Actions: Link GitHub Pull Request to Backlog issue.

Prerequisite

• Backlog Premium plan (ref. Backlog Pricing)
• Create custom field named "Pull Request" in Backlog issue

Usage

# .github/workflows/backlog-pr-link.yml
name: 'Link PR to Backlog'

on:
  pull_request:
    types: [opened, edited]

jobs:
  backlog-pr-link:
    runs-on: ubuntu-latest
    steps:
      - uses: toshimaru/[email protected]
        with:
          backlog-api-key: "${{ secrets.BACKLOG_API_KEY }}"
          backlog-host: "your-org.backlog.com"

Tips: Avoiding unnecessary runs

If the pull request doesn't contain a Backlog URL, no need to run this action.

To avoid this situation, you can skip the job by using if expression as follows:

# Run the job only when the pull request contains a Backlog URL
jobs:
  backlog-pr-link:
    runs-on: ubuntu-latest
    if: contains(github.event.pull_request.body, 'https://yourhost.backlog.com/')
    steps:
      - ...

How it works

• Check the pull request has a Backlog issue URL when it's opened or edited
• If it has the URL, link GitHub PR to Backlog issue

Setup

1. Create a custom field named Pull Request

• Custom Field: Pull Request
• Custom Field Type: Sentence

Image: Create a custom field

Reference

• [English] Setting Custom fields - Backlog Enterprise
• [Japanese] カスタム属性の設定方法 – Backlog ヘルプセンター

2. Generate Backlog API key

• Go to Backlog API Settings page
• Generate API key for the action

Image: Generate Backlog API key

Reference

• [English] API Settings – Backlog Help Center
• [Japanese] APIの設定 – Backlog ヘルプセンター

3. Set API key to GitHub Secret

• Go to GitHub Actions secrets page
• Add GitHub Repository secret
  • secret name: BACKLOG_API_KEY
  • secret value: {your-backlog-api-key}

Image: Set API key to GitHub Secret

Reference

• Encrypted secrets - GitHub Docs