Skip to main content
POST
/
webhooks
Create webhook
curl --request POST \
  --url https://api.surefeedback.com/api/v1/webhooks \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "url": "<string>",
  "events": [
    {}
  ],
  "secret": "<string>"
}
'
{
  "success": true,
  "data": {
    "id": "dd0e8400-e29b-41d4-a716-446655440008",
    "url": "https://myapp.com/webhooks/surefeedback",
    "events": ["comment.created", "comment.resolved"],
    "is_active": true,
    "created_at": "2026-03-02T12:00:00Z"
  }
}
Registers a new webhook URL to receive real-time event notifications.

​
Request body

​
url
string
required
The HTTPS URL that will receive POST requests when events fire.
​
events
array
required
Array of event types to subscribe to. See supported events below.
​
secret
string
Optional secret used to sign webhook payloads. Verify the X-Signature header to ensure requests are from SureFeedback.

​
Supported events

EventTrigger
comment.createdA new comment is posted
comment.resolvedA comment is resolved
comment.assignedA comment is assigned to a user
comment.repliedA reply is added to a comment
page.approvedA page is marked as approved
page.unapprovedA page’s approval is removed
{
  "success": true,
  "data": {
    "id": "dd0e8400-e29b-41d4-a716-446655440008",
    "url": "https://myapp.com/webhooks/surefeedback",
    "events": ["comment.created", "comment.resolved"],
    "is_active": true,
    "created_at": "2026-03-02T12:00:00Z"
  }
}