Webhook Automation

Set a webhook_url to get real-time notifications when feedback is submitted.

Setup

When publishing, include a webhook URL:

{
  "html": "...",
  "title": "Deploy Approval",
  "questions": [{ "id": "go", "type": "approve", "text": "Ship it?" }],
  "webhook_url": "https://your-server.com/profer-webhook"
}

Webhook payload

When a reviewer submits feedback, Profer POSTs:

{
  "event": "feedback_received",
  "page_id": "PF-K8M3N",
  "version": 1,
  "answers": { "go": "yes" },
  "reviewer": "Alice"
}

Use cases

• Deploy gates: Agent publishes a deploy plan, waits for webhook confirmation before running deploy
• Slack notifications: Forward webhook to Slack for team visibility
• CI/CD integration: Trigger a pipeline when a spec is approved
• Audit logging: Record every approval decision

Important

Webhook failures are non-blocking — feedback is stored regardless of whether the webhook succeeds. Design your automation to also poll via get() as a fallback.