Webhooks Integration
Get real-time updates and push notifications about your data processing events directly to your application.
Getting Started
Webhooks let you receive real-time event notifications for all EasyMA operations. Here's how to set one up:
- 1 Go to the Webhooks Settings in your dashboard.
- 2 Enter your endpoint URL where you want to receive notifications.
- 3 Validate the webhook with our test payload.
POST /your/webhook/endpoint
Headers:
X-EasyMA-Topic: data_processed
Body:
{
"event": "data_processed",
"created_at": "2025-09-14T14:30:00.000Z",
"data_id": "abc123",
"status": "success"
}
Supported Events
data_received
Triggered when new data arrives in our system. Includes metadata about the incoming request.
data_processed
Notifies you when a data batch has completed processing successfully.
failed_delivery
Sent when we can't deliver a notification five times in a row.
delivery_success
Confirmation that your webhook endpoint successfully received an event.
Security & Validation
Signature Verification
We include a digital signature header for every webhook. Validate using your unique API secret for authenticity.
HTTPS Requirement
All webhook endpoints must use HTTPS to ensure secure communication.
// Signature verification example
const crypto = require('crypto');
const isValid = crypto.timingSafeEqual(
Buffer.from(signingSecret),
Buffer.from(signatureHeader)
);