Backlog

Users with administrative privileges can find this integration below the list of personal alert integrations on the Alerts & Integrations tab of the Project Settings page.

Backlog is a project management and collaboration platform that helps teams track issues, tasks, and bugs. Honeybadger automatically creates issues in Backlog when errors occur and keeps the status in sync, making it easy to track bug fixes as part of your project workflow.

Setup

1. Select the Backlog integration

2. Enter your Space URL

Your Space URL is the full URL of your Backlog space, including the protocol. For example:

• https://example.backlog.com (for international spaces)
• https://example.backlog.jp (for Japanese spaces)

3. Set the API key

You can generate an API key from your Backlog account:

1. Go to Personal Settings in Backlog
2. Navigate to the API section
3. Generate a new API key
4. Copy the key and paste it into the API Key field

4. Fetch projects

Click the Fetch Projects button to retrieve your Backlog projects. This will populate the project dropdown and enable the remaining configuration options.

5. Select project and configure issue settings

Choose the Backlog project where issues should be created, then configure the required settings:

• Issue Type: The type of issue to create (bug, task, etc.)
• Priority: The priority level for created issues
• Closed Status: The status to transition issues to when errors are marked as resolved
• Open Status: The status to transition issues to when errors are reopened

By default, Honeybadger will automatically create a Backlog issue when a new error occurs, and sync status updates between Backlog and Honeybadger. See Two-way sync with Backlog for additional options.

6. Save

That’s it! You can test the integration by clicking “Test this integration”. Otherwise, just save it and you’re ready to go.

Two-way sync with Backlog

Honeybadger provides seamless two-way synchronization with Backlog by default.

From Honeybadger to Backlog:

• Automatically create an issue when an error occurs: When a new error occurs, Honeybadger creates a new issue in Backlog with the Open Status
• Automatically resolve issues: When you resolve an error in Honeybadger, Honeybadger transitions the Backlog issue to the Closed Status
• Automatically reopen issues: When you unresolve (reopen) an error in Honeybadger, Honeybadger transitions the Backlog issue to the Open Status

From Backlog to Honeybadger:

• Sync status from Backlog: Honeybadger creates a webhook in your Backlog project that automatically syncs status changes back to Honeybadger:
  • When a Backlog issue’s status changes to your selected Closed Status: the error is automatically resolved in Honeybadger
  • When a Backlog issue’s status changes from your selected Closed Status to any other status: the error is automatically unresolved in Honeybadger

These options are enabled by default to keep your Backlog issues and Honeybadger errors in sync automatically. You can uncheck any of these options if you prefer to create/update issues manually.

For additional integration options, see the integrations guide.