# Build on your support and feedback with a REST API

> A REST API and signed webhooks for your feedback, changelog, help center, support inbox and status page. Scoped API keys and an OpenAPI reference included.

Source: https://quackback.io/features/api

API and webhooks

Read and write posts, votes, the changelog, help center articles, conversations and tickets. Signed webhooks tell your systems the moment something changes.

Terminal

```
curl https://feedback.acme.com/api/v1/posts \
  -G -d sort=votes -d limit=2 \
  -H "Authorization: Bearer $QUACKBACK_API_KEY"
```

Webhook · post.status_changed

```
{
  "id": "3f2b8c1e-6d4a-4e2b-9a57-0c1d2e3f4a5b",
  "type": "post.status_changed",
  "createdAt": "2026-10-06T09:14:00.000Z",
  "data": {
    "post": {
      "id": "post_01h455vb4pex5vsknk084sn02q",
      "title": "Recurring invoices",
      "boardSlug": "feature-requests"
    },
    "previousStatus": "Planned",
    "newStatus": "In Progress"
  }
}
```

200 OK · application/json

```
{
  "data": [
    {
      "id": "post_01h455vb4pex5vsknk084sn02q",
      "title": "Recurring invoices",
      "voteCount": 323,
      "boardSlug": "feature-requests"
    },
    {
      "id": "post_01h455vb4pex5vsknk084sn02r",
      "title": "Multi-currency support",
      "voteCount": 298,
      "boardSlug": "feature-requests"
    }
  ],
  "meta": {
    "pagination": {
      "cursor": "eyJvZmZzZXQiOjJ9",
      "hasMore": true
    }
  }
}
```

## One API for your whole workspace

Everything your team does in Quackback, your code can do too. Each workspace serves its own interactive reference at /api/v1/docs.

[Read the API overview](https://feedback.quackback.io/hc/en/articles/147-api-overview)

### Feedback

Posts, votes, comments, boards, statuses, tags and roadmaps. Add a vote for a customer who asked on a call.

### Changelog

Draft, publish or schedule entries from your release process, and link them to the requests they ship.

### Help center

Write and publish articles and categories from the tools where your docs already live.

### Conversations and tickets

Read threads, reply, add notes, assign and change status from your own systems.

### Status page

Update components and open incidents straight from your monitoring tools.

### Customers

Users and companies, so every request carries the context from your app. Segments are on Business and up.

## Webhooks for everything that changes

Skip the polling. Quackback sends a signed request to your endpoint whenever a post, comment, changelog entry, conversation or ticket changes.

### Subscribe to the events you need

Create a webhook in Settings or over the API. Pick events across feedback, support and the changelog, and limit post events to the boards you care about.

Terminal

```
curl -X POST https://feedback.acme.com/api/v1/webhooks \
  -H "Authorization: Bearer $QUACKBACK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.acme.com/hooks/quackback",
    "events": ["post.created", "post.status_changed"]
  }'
```

### Verify every delivery

Each request carries an HMAC-SHA256 signature and a timestamp. Check both, respond quickly, and failed deliveries are retried over several hours.

[Read the webhooks guide](https://feedback.quackback.io/hc/en/articles/48-webhooks)

webhook.js

```
import crypto from "node:crypto";

// Signed over "{timestamp}.{raw body}" with your webhook secret
export function isValid(rawBody, headers, secret) {
  const timestamp = headers["x-quackback-timestamp"];
  // Reject deliveries more than 5 minutes old
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
  const expected =
    "sha256=" +
    crypto
      .createHmac("sha256", secret)
      .update(`${timestamp}.${rawBody}`)
      .digest("hex");
  const signature = headers["x-quackback-signature"] ?? "";
  return (
    signature.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
  );
}
```

## Built the way you'd expect

[Working with AI agents? Explore the MCP server](https://quackback.io/features/mcp.md)

**Scoped API keys**: Read, or read and write, for feedback, the help center, conversations and settings. Changelog access is write only.

**Rotate and revoke**: Rotate a key and the old one stops working straight away.

**[OpenAPI spec](https://feedback.quackback.io/api/v1/docs)**: Generate a client from /api/v1/openapi/json on your workspace.

**Cursor pagination**: Up to 100 results a page, with a cursor for the next.

**One error shape**: Every error returns a status, a code and a readable message.

**[Set up the API](https://quackback.io/integrations/api.md)**: Create a scoped key and make your first request.

**[Set up webhooks](https://quackback.io/integrations/webhooks.md)**: Pick the events, add your endpoint and verify the signature. On Pro and up.

**[Same on Cloud and self-hosted](https://quackback.io/self-hosted.md)**: The same API runs on our cloud and on your own servers.

## Common questions

### Which plans include the API and webhooks?

On Quackback Cloud, the REST API is included on every plan, including Free, and webhooks and the MCP server are included from Pro, each paid plan with a 14-day free trial. Rate limits rise with the plan, from 60 requests a minute on Free and Pro to 1,200 on Enterprise. The open-source, self-hosted edition includes all of them at no cost.

### How do I authenticate with the Quackback API?

Create an API key in Settings, under Developers, and send it as a Bearer token in the Authorization header. Keys start with qb_, are shown once, and carry only the access you give them.

### Is there an OpenAPI spec?

Yes. Browse the public reference at https://feedback.quackback.io/api/v1/docs. Every workspace also serves its own interactive reference at /api/v1/docs and the OpenAPI spec at /api/v1/openapi/json, matching the version you run, so you can generate a client in any language.

### What are the API rate limits?

Requests are limited per minute. Self-hosted installs allow 100 requests a minute by default, and on Quackback Cloud the limit depends on your plan. Over the limit, you get a 429 response with a Retry-After header.

### Should I poll the API or use webhooks?

Use webhooks for anything that should happen when something changes. Quackback sends a signed request as soon as a post, comment, conversation or ticket changes, so there's nothing to poll.

Have another question? [Talk to the team](https://quackback.io/contact.md).

## Start building on Quackback

[Start free trial](https://app.quackback.io/signup?plan=pro&from=features-api-final) [Read the API docs](https://feedback.quackback.io/hc/en/articles/147-api-overview)
