Feedback received

Fires when a reader rates an article in the help center or widget.

POST feedback.received

Bearer token

curl 'https://api.ferndesk.com/v1/feedback.received' \
  --request POST \
  --header 'webhook-id: whevt_01JXYC5R2K9M' \
  --header 'webhook-timestamp: 1752096000' \
  --header 'webhook-signature: v1,K5oT8v...base64...' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "whevt_01JXYC5R2K9M",
  "type": "feedback.received",
  "created_at": "2026-07-09T18:25:43.511Z",
  "data": {
    "id": "artfb_01JXY9AZK4KV",
    "article_id": "art_01JXY9AZK4KV",
    "type": "positive",
    "feedback": "This walkthrough was clear and accurate.",
    "hc_user_id": "hcusr_01JXYB3S2Y8C"
  }
}'

This response has no body.

Delivery acknowledged; anything else is retried with backoff.

Headers

· 3

webhook-id string required

Envelope id, unique per event.

webhook-timestamp string required

Unix seconds when the request was signed; reject stale values.

webhook-signature string required

Space-separated v1, tokens — several during secret rotation — computed as described under Signature verification.

Body

required application/json

id string required

Event identifier, repeated in the webhook-id header.

type string · enum required

Event type carried by this delivery.

values

feedback.received

created_at string required

When the event was created.

data object required

Reader feedback with the submitter email withheld; resolve hc_user_id through the users API if you need contact details.

Headers

Body

Responses