Skip to content

Integrations & API

Today BugBasket connects to the rest of your stack through signed webhooks and a REST API. Native, click-to-connect integrations are on the roadmap, and we will say so plainly until they ship.

Start free trial

API and webhooks are included in Pro. 14-day free trial, no credit card required.

Available today

Two building blocks that let you wire BugBasket into anything that speaks HTTP.

Available

Webhooks

Push every issue to your own endpoint

Point BugBasket at a URL you control and get an HTTP POST the moment a report comes in, changes status or gets resolved. That is enough to build any workflow you need today.

  • POST for issue.created, issue.updated and issue.resolved
  • Signed payloads: HMAC-SHA256 in X-BugBasket-Signature
  • Scope a webhook to one project or all of them
  • Best-effort delivery with a 5-second timeout, so answer 2xx fast
Available

REST API

Read and manage issues from your own code

A small, predictable REST API over your workspace. List and filter issues, update their status, manage projects and API keys, and pull aggregate counts into your own reporting.

  • JSON endpoints under https://api.bugbasket.com/api/v1
  • Bearer API keys with read, write and admin scopes
  • Filter issues by type, status, project and free-text search
  • Keys can be scoped to a single project

How webhooks work

From new webhook to working automation in four steps

Step 1

Add a webhook

In the dashboard, go to Settings, Webhooks and add the endpoint URL that should receive the POST requests.

Step 2

Pick your events

Tick the events you care about and optionally limit the webhook to a single project.

Step 3

Verify the signature

Check X-BugBasket-Signature against the raw request body with your signing secret, then return 2xx.

Step 4

Do your thing

Create a ticket, ping a channel, write to your warehouse. The payload carries the issue and its context.

Developer reference

Build your own integration

Every delivery is a JSON POST with the event name in a header and an HMAC-SHA256 signature over the raw body. Verify it, answer 2xx, and queue the work on your side.

  • Three events: issue.created, issue.updated, issue.resolved
  • X-BugBasket-Event and X-BugBasket-Signature headers
  • Signing secret shown once when you create the webhook
  • Per-project or workspace-wide delivery
  • REST API for reading, filtering and updating issues

The full developer reference lives in the app under Help, API and webhooks, with endpoints, scopes, error codes and rate limits.

Start free trial
Webhook deliveryJSON
POST /your-endpoint
X-BugBasket-Event: issue.created
X-BugBasket-Signature: 9f2c...a41b

{
  "event": "issue.created",
  "timestamp": "2026-07-08T10:30:00.000Z",
  "data": {
    "issue": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "bug",
      "description": "The submit button does nothing on checkout",
      "status": "open"
    }
  }
}
On the roadmap

Native integrations are coming

Connect-with-one-click integrations, including two-way status sync, are not built yet. None of the tools below are live. Until they are, webhooks and the API cover the same ground with a bit more work on your side.

Coming soon

Linear

Issue tracking for software teams

🔷Coming soon

Jira

Enterprise project management

Coming soon

Asana

Work management platform

#Coming soon

Slack

Notifications in your channels

Coming soon

Trello

Visual project boards

Coming soon

GitHub

Issues for developers

Coming soon

Notion

All-in-one workspace

Coming soon

Zapier

Connect to everything else

Need one of these sooner rather than later? Tell us which, and it moves up the list.

Ready to wire up your workflow?

Start with webhooks and the API today. 14-day free trial, no credit card required.