Skip to content

The Webhooks admin screen

Outbound Webhooks let WB Gamification send real-time event data to external services like Zapier, Make (formerly Integromat), or n8n. Each time a qualifying event fires on your site, the WebhookDispatcher sends a signed HTTP POST to your configured endpoint.

Event When It Fires
points_awarded Any time a member earns points
badge_earned A badge is awarded to a member
level_changed A member moves to a new level
streak_milestone A member hits a streak milestone
challenge_completed An individual challenge is completed
kudos_given A member gives kudos to another member
  1. Go to WB Gamification → Webhooks → Add Webhook.
  2. Enter the destination URL (your Zapier webhook URL, Make webhook, etc.).
  3. Check the events you want this endpoint to receive.
  4. Click Save. The plugin generates a secret key for this webhook.

The destination must be a public https:// address. WB Gamification refuses an address that is not https, a host it cannot find, and any address that points at your own server or a private network, and the message tells you which one it is. Deliveries use WordPress’s safe request, so a webhook cannot reach internal services.

A webhook keeps the active setting you choose. Editing a paused webhook does not turn it back on.

You can create multiple webhooks for different destinations or event subsets.

Each POST request sends a JSON body:

{
"event": "points_awarded",
"user_id": 42,
"data": { ... },
"timestamp": 1700000000
}

The exact data keys vary by event type.

Every request includes an X-WB-Gam-Signature header. The value is an HMAC-SHA256 hash of the raw request body, signed with the webhook’s secret key.

To verify in your receiving application:

$signature = hash_hmac( 'sha256', $raw_body, $secret_key );
// Compare with the X-WB-Gam-Signature header value.

Always verify signatures before processing webhook data. Reject any request where the signature does not match.

View all registered webhooks, their last delivery status, and recent delivery logs at WB Gamification → Webhooks. You can pause, edit, or delete any webhook from this screen.