Webhooks & Slack
Business plans can push audit events to your HTTPS endpoint or a Slack incoming webhook.
Setup
Add endpoints in Dashboard → Integrations. The webhook signing secret is shown once when you create an endpoint.
- Add a webhook URL (HTTPS required)
- Copy the signing secret immediately
- Verify X-WPAQ-Signature on every incoming request
Event payload
WPAQ POSTs JSON when an audit reaches a terminal state. A new endpoint subscribes to scan.completed unless you pass events. Delivery is one attempt, an 8 second timeout, and no retry. You can also manage endpoints with the REST API or the MCP server. Both require Business.
| Event | When |
|---|---|
scan.completed | Site Audit finished. Failed and blocked Site Audits do not send an event. |
visibility.completed visibility.failed visibility.blocked | AI Visibility Audit, once. |
conversion.completed conversion.failed conversion.blocked | Conversion Audit, once. |
quality.completed quality.failed quality.blocked | Content Quality Audit, once. |
{
"event": "scan.completed",
"data": {
"scan_id": "abc123",
"hostname": "example.com",
"overall_score": 91,
"report_url": "https://wpaq.com/site-audit/abc123",
"audit_type": "scan",
"audit_id": "abc123",
"website": "example.com",
"status": "completed",
"score": 91,
"api_url": "https://wpaq.com/api/v1/site-audits/abc123"
},
"sent_at": "2026-08-31T12:00:00+00:00"
}{
"event": "visibility.completed",
"data": {
"audit_type": "visibility",
"audit_id": "vis_example",
"website": "example.com",
"status": "completed",
"score": 78,
"report_url": "https://wpaq.com/visibility-audit/vis_example",
"api_url": "https://wpaq.com/api/v1/ai-visibility-audits/vis_example"
},
"sent_at": "2026-08-31T12:00:00+00:00"
}Conversion and Content Quality use the same data fields with audit_type conversion or quality, and report paths /conversion-audit/ and /quality-audit/. Failed and blocked events set status to match and may send score: null.
Request headers:
- X-WPAQ-Event
- Event name, e.g.
scan.completed - X-WPAQ-Signature
- HMAC-SHA256 of the raw request body, prefixed with
sha256=
Delivery is best-effort, not at-least-once: each event is sent once with an 8-second timeout and no automatic retry. If your endpoint is down or slow, that delivery is lost — poll GET /api/v1/site-audits/{id} from the REST API as a reconciliation fallback for anything you can't afford to miss. Endpoints must resolve to a public HTTPS host — requests to private/internal addresses are blocked before they're sent.
Verify signatures
Reject requests when the signature does not match. Use constant-time comparison in production.
import hmac, hashlib
def verify(body: bytes, secret: str, header: str) -> bool:
expected = "sha256=" + hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, header)# BODY = raw request body bytes
# SECRET = signing secret from Integrations
python3 - <<'PY'
import hmac, hashlib, os
body = os.environ["BODY"].encode()
secret = os.environ["SECRET"].encode()
print("sha256=" + hmac.new(secret, body, hashlib.sha256).hexdigest())
PYSlack alerts
Paste a Slack incoming webhook URL in Integrations. WPAQ posts a short message when Site Audits complete or when monitored sites change health.
- Slack URLs are stored on your account — treat them like passwords.
- They are not re-displayed after you save them.
- Remove a connection anytime from Dashboard → Integrations.
- Messages are plain text summaries, not signed payloads.
Open the report
Each payload includes report_url — a direct link to the Site Audit report. Recipients need to be signed in to the owning account unless you have shared the report separately with a share link (Pro and Business).