SourceWire API v1

Webhooks

Signed article.published events with HMAC verification, delivery logs, and HTTPS-only endpoints.

Webhooks push new stories to your endpoint the moment they go live. The v1 event is article.published.

{
  "id": "event_…",
  "event": "article.published",
  "created_at": "2026-08-25T12:00:00Z",
  "data": { "article_id": "sw_…" }
}

Deliveries are JSON over HTTPS only, carry unique event IDs, are retried on failure, and are recorded in a delivery log. Each request is signed with x-sourcewire-signature: sha256=…. Verify the HMAC over the raw request body with your signing secret.

Registration (POST /api/v1/webhooks) currently requires a provisioned partner key. Partner webhook registration is available on request via contact. Feeds and the read API need no registration at all.