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 trialAPI 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.
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
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
Add a webhook
In the dashboard, go to Settings, Webhooks and add the endpoint URL that should receive the POST requests.
Pick your events
Tick the events you care about and optionally limit the webhook to a single project.
Verify the signature
Check X-BugBasket-Signature against the raw request body with your signing secret, then return 2xx.
Do your thing
Create a ticket, ping a channel, write to your warehouse. The payload carries the issue and its context.
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 trialPOST /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"
}
}
}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.
Linear
Issue tracking for software teams
Jira
Enterprise project management
Asana
Work management platform
Slack
Notifications in your channels
Trello
Visual project boards
GitHub
Issues for developers
Notion
All-in-one workspace
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.