WEBHOOK Developer Tools

Webhooks + eCardWidget

Name: Webhooks + eCardWidget
Brand: eCardWidget
Availability: InStock

Real-time eCard and directory events, signed and retried.

Start Free Trial Read the docs

What you unlock

Everything you need to send branded eCards from Webhooks

HMAC-signed events

Every payload signed with your secret. Verify authenticity before you act.

Retry with backoff

5 attempts with exponential backoff on non-2xx. No dropped events.

Delivery log & replay

Every attempt logged with full payload. Re-fire any event from the dashboard.

Why it works

Pair Webhooks with eCardWidget

eCardWidget emits webhook events whenever an eCard is shared or a directory member changes — so your CRM, data warehouse, or internal tools always know the current state without polling.

Example use case

A donor opens their thank-you eCard → ecard_shared fires with delivery status → your CRM logs a 'thank-you-opened' engagement event for stewardship workflows.

Live in minutes, not weeks.

Setup guide

How to integrate Webhooks and eCardWidget

1Set your Webhook URL in Settings → Developers to receive ecard_shared events.
2Subscribe to member-change events via POST /team-member-actions/subscribe.
3Verify the X-ECW-Signature header (HMAC-SHA256 of timestamp + body).
4Return 2xx to acknowledge — failures retry with exponential backoff (5 attempts).
5Inspect deliveries and replay in the developer portal.

Frequently asked

Webhooks + eCardWidget questions

How do I verify the webhook signature?

Compute HMAC-SHA256 of the request body + timestamp using your webhook secret, then compare with the X-ECW-Signature header. Full example code in the docs.

What happens if my endpoint is down?

We retry with exponential backoff — 5 attempts over ~15 minutes. After that, the event is marked failed and available for manual replay in the dashboard.

Can I replay events?

Yes. Every delivery attempt is logged and can be re-fired to your endpoint from the developer portal.