Skip to main content

​
Webhooks

Webhooks let your application receive real-time HTTP notifications when events happen in GiveLink. Use them to build custom integrations, sync data, or trigger workflows.

​
Setup

  1. Go to Dashboard > Settings > Webhooks
  2. Enter your endpoint URL (must be HTTPS)
  3. Select which events to subscribe to
  4. Save — GiveLink will send a test event to verify your endpoint

​
Events

EventDescription
donation.createdA new donation was initiated
donation.succeededA donation payment was completed
donation.failedA donation payment failed
donation.refundedA donation was refunded
donor.createdA new donor record was created
campaign.createdA new campaign was created
campaign.updatedA campaign was updated

​
Payload Format

{
  "event": "donation.succeeded",
  "timestamp": "2026-02-28T12:00:00.000Z",
  "data": {
    "id": "clx1111111111",
    "amountCents": 5000,
    "donorId": "clx2222222222",
    "campaignId": "clx9876543210",
    "orgId": "clx1234567890"
  }
}

​
Verification

All webhook payloads include an X-GiveLink-Signature header. Verify this signature using your webhook secret to ensure the request came from GiveLink and wasn’t tampered with.

​
Retry Policy

If your endpoint returns a non-2xx status code, GiveLink retries with exponential backoff:
  • Retry 1: 1 minute
  • Retry 2: 5 minutes
  • Retry 3: 30 minutes
  • Retry 4: 2 hours
  • Retry 5: 12 hours
After 5 failed attempts, the webhook is marked as failed and visible in your dashboard.