Developer Documentation

Webhook Overview

Webhooks allow your application to receive real-time HTTP POST notifications when data changes in FundraiserMax. Instead of polling the API for updates, you register a URL and FundraiserMax pushes events to your endpoint as they occur.

How Webhooks Work

1. Navigate to Settings > Webhooks in your FundraiserMax dashboard and add a new webhook endpoint URL (must be HTTPS).
2. Select the event types you want to receive (e.g., contact.created, donation.created).
3. FundraiserMax generates a signing secret for the webhook. Save this secret — you will use it to verify payload signatures.
4. When a subscribed event occurs, FundraiserMax sends a POST request to your URL with a JSON payload containing the event type and resource data.
5. Your endpoint should return a 2xx status code within 10 seconds to acknowledge receipt.

Webhook Payload Structure

{
  "id": "whevt_abc123",
  "type": "contact.created",
  "timestamp": "2026-02-16T12:00:00Z",
  "accountId": "acct_123",
  "data": {
    "id": "cnt_def456",
    "firstName": "John",
    "lastName": "Smith",
    "email": "john.smith@example.com"
  }
}