Private previewWorkspaces are by invitation

HeedPost

01Collect

Feedback boardsBoards that ask for exactly what your team needs to act.Votes, comments & mentionsOne vote per person, threads with mentions, and notes only your team sees.In-app widgetFeedback from inside your product, from customers who are already signed in.

02Understand

Merge & duplicatesTen posts asking for the same thing become one, with every vote kept.User segments & revenueProSee which requests your biggest customers want, in dollars.InsightsWho reads, what's rising, and whether you answered.HeedPost AIPlus and ProTags, duplicate judging, drafts, summaries, themes and Ask, each with its own switch.

03Ship and tell

Roadmap & statusesMove a post and everyone who asked hears, in your own status words.ChangelogRelease notes linked to the requests behind them, mailed to everyone who asked.Notifications & digestThe right email to the right person, and a switch for every one.

04Run it

Activity logEvery change, who made it and when, a day at a time.Team, roles & sign-inUnlimited teammates, clear roles, and sign-in your way.Branding, domain & languagesYour logo and colour, your own domain, and 21 languages.ImportMove in from Canny, Featurebase or UserJot, with nobody emailed.

05Connect

Slack & issue trackersPlus and ProSlack threads, and issues in Linear, Jira, GitHub or ClickUp that move posts back.MCP serverPlus and ProYour AI agent can read, file, vote and ship, as you.REST APIPlus and Pro27 operations and one key: build anything on top of your feedback.WebhooksPlus and Pro110 events, signed and retried, the moment they happen.
AIDocsHelpPricingBlog

Collect

Understand

Ship and tell

Run it

Connect

Request an inviteSign in

DocsReference

Webhooks

We post each change to your server as it happens, signed, retried, and safe to receive twice.

Plan Plus and ProEvents 110 typesSignature HMAC-SHA256

Add an endpoint

On Settings › API, webhooks and MCP, or through the API with POST /v1/webhooks. Give it a URL and the events it wants.

  1. Choose events. An empty list means every type we send, except the high-volume ones marked opt-in, which have to be named.
  2. Store the signing secret. It's shown twice and never again: when you create the endpoint, and when you rotate it. Every other response, including the list and the edit, leaves it out. If you lose it, rotate it. Your receiver will treat deliveries as unsigned until it has the new secret.
  3. Answer fast. Return a 2xx within 10 seconds and do slow work afterwards.

A webhook endpoint counts as an integration: Plus includes one, Pro has no limit. We do not follow redirects, and an endpoint that answers one is recorded as a failure with the address it pointed at.

What arrives

A POST with a JSON body and three headers you can rely on: X-Heedpost-Signature, X-Heedpost-Event (the type) and the user agent Heedpost-Webhooks/1.

JSON
{
  "id": "0192f3c4-…",                 // the event's own id: dedupe on it
  "type": "post.status_changed",
  "created_at": "2026-10-17T09:12:44.512+00:00",
  "workspace": { "id": "…", "slug": "acme" },
  "actor": { "id": "…", "name": "Dana Whitfield" },   // null when nobody acted
  "subject": { "type": "post", "id": "…" },
  "data": { "from": "review", "to": "planned",
            "from_name": "Under review", "to_name": "Planned" }
}

data carries named keys only, listed per type in the catalog below, so a payload that grows a field never grows a leak. No email address is ever in a body: a member's id goes instead, which an API key can resolve.

Verify the signature

X-Heedpost-Signature is an HMAC-SHA256 over the timestamp and the raw body:

X-Heedpost-Signature: ts=1724500000;h1=<hex>

Check the timestamp as well as the signature. The timestamp is part of what's signed, so nobody can change it without breaking the signature. Without a time limit, though, a copied request would stay valid forever. The examples allow five minutes.

Verify against the raw bytes. Re-serialising the JSON first produces a different document and a signature that never matches.

import hmac, hashlib, time

def verify(secret: str, header: str, raw_body: bytes, window: int = 300) -> bool:
    """header is X-Heedpost-Signature: ts=<unix>;h1=<hex>"""
    parts = dict(p.split("=", 1) for p in header.split(";") if "=" in p)
    ts, sent = parts.get("ts", ""), parts.get("h1", "")
    if not ts.isdigit() or abs(time.time() - int(ts)) > window:
        return False  # stale, or from the future
    signed = ts.encode() + b":" + raw_body  # the raw bytes, never re-serialised JSON
    digest = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
    return hmac.compare_digest(digest, sent)

Retries and duplicates

Timeout

10 seconds per attempt.

Retries

8 attempts for a 5xx or a timeout, each wait twice the last.

Duplicates

Delivery is at least once. A retried delivery carries the same event id, so dedupe on it.

Resending

From the delivery log on Settings · API, webhooks and MCP, 60 an hour.

Event catalog

110 types in 23 families, each with the keys its data carries. vote.added is the one opt-in type: it carries the new total and never says who voted.

api key 2

api_key.created

Nothing in data. The type and subject say it all.

api_key.revoked

Nothing in data. The type and subject say it all.

board 5

board.created

slug, name

board.deleted

slug, name

board.reordered

order

board.restored

slug, name

board.updated

name, was

board category 5

board_category.created

name, board_id

board_category.deleted

name, board_id

board_category.reordered

order, board_id

board_category.restored

name, board_id

board_category.updated

name, was, board_id

board field 5

board_field.created

key, label, type, board_id

board_field.deleted

key, label, board_id

board_field.reordered

order, board_id

board_field.restored

key, label, board_id

board_field.updated

key, label, was, board_id

changelog 5

changelog.created

slug, title

changelog.deleted

slug

changelog.published

slug, title, posts

changelog.restored

slug

changelog.updated

slug, changed

changelog label 4

changelog_label.created

name, color

changelog_label.deleted

name

changelog_label.restored

name

changelog_label.updated

name, was, changed

clickup 6

clickup.connected

Nothing in data. The type and subject say it all.

clickup.disconnected

Nothing in data. The type and subject say it all.

clickup.issue_linked

issue, created

clickup.issue_unlinked

issue

clickup.reconnected

Nothing in data. The type and subject say it all.

clickup.updated

Nothing in data. The type and subject say it all.

comment 4

comment.created

post_id, is_internal

comment.deleted

post_id

comment.restored

post_id

comment.updated

post_id

custom domain 4

custom_domain.added

hostname

custom_domain.primary_changed

hostname

custom_domain.removed

hostname

custom_domain.verified

hostname

digest 1

digest.sent

posts, shipped

github 6

github.connected

Nothing in data. The type and subject say it all.

github.disconnected

Nothing in data. The type and subject say it all.

github.issue_linked

issue, created

github.issue_unlinked

issue

github.reconnected

Nothing in data. The type and subject say it all.

github.updated

Nothing in data. The type and subject say it all.

import 3

import.failed

provider, state

import.finished

provider, state, boards, posts, comments, votes, people, user_segments, releases, images

import.started

provider

jira 6

jira.connected

Nothing in data. The type and subject say it all.

jira.disconnected

Nothing in data. The type and subject say it all.

jira.issue_linked

issue, created

jira.issue_unlinked

issue

jira.reconnected

Nothing in data. The type and subject say it all.

jira.updated

Nothing in data. The type and subject say it all.

linear 6

linear.connected

Nothing in data. The type and subject say it all.

linear.disconnected

Nothing in data. The type and subject say it all.

linear.issue_linked

issue, created

linear.issue_unlinked

issue

linear.reconnected

Nothing in data. The type and subject say it all.

linear.updated

Nothing in data. The type and subject say it all.

member 5

member.invite_revoked

role

member.invited

role

member.joined

role

member.removed

user_id, role

member.role_changed

from, to

post 16

post.board_changed

from, to, from_name, to_name, from_slug, to_slug, category_cleared

post.category_changed

from, to, from_name, to_name

post.comments_locked

note

post.comments_unlocked

Nothing in data. The type and subject say it all.

post.created

title, board_id, is_private

post.deleted

Nothing in data. The type and subject say it all.

post.merged

into, title, votes, comments, shared_voters

post.pinned

Nothing in data. The type and subject say it all.

post.plan_changed

owner_id, target_date, was

post.privacy_changed

is_private

post.restored

Nothing in data. The type and subject say it all.

post.status_changed

from, to, from_name, to_name

post.tags_changed

added, removed

post.unmerged

from

post.unpinned

Nothing in data. The type and subject say it all.

post.updated

title, by_author

slack 4

slack.connected

Nothing in data. The type and subject say it all.

slack.disconnected

Nothing in data. The type and subject say it all.

slack.reconnected

Nothing in data. The type and subject say it all.

slack.updated

Nothing in data. The type and subject say it all.

sso 4

sso.configured

Nothing in data. The type and subject say it all.

sso.disabled

Nothing in data. The type and subject say it all.

sso.enabled

Nothing in data. The type and subject say it all.

sso.rotated

Nothing in data. The type and subject say it all.

status 5

status.created

name, kind

status.deleted

name, moved, moved_to

status.reordered

Nothing in data. The type and subject say it all.

status.restored

name

status.updated

name, kind, was

tag 4

tag.created

name

tag.deleted

name

tag.restored

name

tag.updated

name, was, changed

tenant 5

tenant.closed

name

tenant.created

slug, name

tenant.plan_changed

from, to, why

tenant.reopened

name, closed_at

tenant.updated

name, was

vote 1

vote.addedopt-in

count

webhook 4

webhook.added

url, event_types

webhook.removed

url

webhook.rotated

url

webhook.updated

url, was