Webhook integration for developers

SpeedNetworking sends outbound webhooks when events occur in your workspace - integrate with Zapier, n8n, or a custom backend.

Event types

• event.finished - when an event is finished
• mutual_match.created - when a mutual match is created
• subscription.updated - plan / status change

Configuration

POST to /api/v1/webhooks/ with the payload:

{
  "url": "https://twoja-firma.pl/webhook",
  "events": ["event.finished", "mutual_match.created"]
}

You'll receive a secret - keep it, you'll use it to verify signatures.

Format payload

{
  "event": "event.finished",
  "data": {
    "event_id": 42,
    "title": "Networking Q1",
    "mutual_matches_count": 17,
    "...": "..."
  }
}

Signature verification

Every POST includes the headers:

• X-SpeedNetworking-Event: event.finished
• X-SpeedNetworking-Signature: <hmac-sha256 hex>

Verification:

import hmac, hashlib
expected = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
if expected != request.headers['X-SpeedNetworking-Signature']:
    return 401

Retry

3 attempts with exponential backoff. A 2xx response is required. After 3 failures, the status shows last_error_message.

Disabling

Setting is_active=false pauses delivery. A disabled webhook doesn't receive events.