Webhooks

Receive real-time notifications when events occur in your loyalty program. Perfect for keeping your systems in sync and automating workflows based on customer behavior.

Webhook Features

Real-time Notifications

Receive instant notifications when events occur in your loyalty program

Secure Delivery

All webhook payloads are signed and delivered over HTTPS for security

Automatic Retries

Failed deliveries are automatically retried with exponential backoff

Event Filtering

Choose which events to receive and customize payload data

Available Events

Subscribe to these events to receive real-time notifications about your loyalty program activity.

customer.created
Triggered when a new customer joins your loyalty program
JSON
Example Payload
{
  "event": "customer.created",
  "data": {
    "id": "cust_123",
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1234567890",
    "created_at": "2024-01-15T10:30:00Z"
  }
}
stamp.earned
Triggered when a customer earns a stamp on their loyalty card
JSON
Example Payload
{
  "event": "stamp.earned",
  "data": {
    "customer_id": "cust_123",
    "card_id": "card_456",
    "stamps_earned": 1,
    "total_stamps": 5,
    "stamps_required": 10,
    "earned_at": "2024-01-15T14:30:00Z"
  }
}
reward.earned
Triggered when a customer earns a reward (completes their stamp card)
JSON
Example Payload
{
  "event": "reward.earned",
  "data": {
    "customer_id": "cust_123",
    "card_id": "card_456",
    "reward_name": "Free Coffee",
    "earned_at": "2024-01-15T16:30:00Z"
  }
}
reward.redeemed
Triggered when a customer redeems their earned reward
JSON
Example Payload
{
  "event": "reward.redeemed",
  "data": {
    "customer_id": "cust_123",
    "card_id": "card_456",
    "reward_name": "Free Coffee",
    "redeemed_at": "2024-01-15T18:30:00Z"
  }
}

Popular Use Cases

See how businesses use webhooks to automate their loyalty program workflows.

CRM Integration

Automatically sync customer data with your CRM when new customers join your loyalty program.

Email Marketing

Trigger personalized email campaigns when customers earn stamps or rewards.

Analytics Tracking

Send loyalty program data to your analytics platform for deeper insights.

Inventory Management

Update inventory systems when rewards are redeemed to track product usage.

Quick Setup Guide

Get your webhooks up and running in just a few steps.

1

Create Your Endpoint

Set up an HTTP endpoint on your server that can receive POST requests. This endpoint will receive the webhook payloads from Stamperly.

POST https://your-domain.com/webhooks/stamperly
2

Configure in Dashboard

Go to your Stamperly dashboard, navigate to Integrations → Webhooks, and add your endpoint URL. Select which events you want to receive.

3

Test Your Integration

Try our test feature to send a sample webhook to your endpoint. This helps you verify that everything is functioning as expected.

Security & Verification

All webhook payloads are signed using HMAC-SHA256 with your webhook secret. Always verify the signature to ensure the request is from Stamperly and hasn't been tampered with.

X-Stamperly-Signature: sha256=your_signature_here