Webhooks

Receive real-time notifications for events

Coming Soon: Webhook functionality is currently in development. Check back soon for updates.

Overview

Webhooks allow demeterrr to send real-time notifications to your application when events occur, such as:

• New survey response submitted
• Review received
• Contact updated
• Sequence completed

Instead of polling the API repeatedly, webhooks push data to your endpoint immediately.

Webhook Events (Planned)

Event	Description
response.created	New survey response submitted
response.updated	Survey response modified
review.created	New customer review received
review.replied	Reply posted to a review
contact.created	New contact added
contact.updated	Contact information changed
sequence.completed	Sequence finished for a contact
sending.failed	Message failed to send

Webhook Payload Format (Planned)

{
  "id": "evt_1234567890",
  "type": "response.created",
  "createdAt": "2026-02-10T10:30:00.000Z",
  "data": {
    "id": "response-uuid",
    "surveyId": "survey-uuid",
    "contactId": "contact-uuid",
    "npsScore": 9,
    "isPromoter": true
  }
}

Setting Up Webhooks (Coming Soon)

1. Navigate to Settings → Webhooks in your dashboard
2. Click Add Webhook Endpoint
3. Enter your endpoint URL (must use HTTPS)
4. Select which events to receive
5. (Optional) Configure a secret for signature verification
6. Save and test your endpoint

Securing Webhooks (Coming Soon)

Verify webhook authenticity using signature validation:

const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');

  return signature === expectedSignature;
}

Next Steps

API Reference

Explore available endpoints

Quick Start

Make your first API call