Webhooks Overview

Webhooks

Webhooks allow your external system to receive real-time HTTP notifications when events occur in the N’entropy platform.

How It Works

1. Register a webhook URL for specific events
2. When an event occurs, we send a POST request to your URL
3. Your server responds with 2xx to acknowledge receipt
4. Failed deliveries are retried automatically

Setting Up a Webhook

Via API

POST /api/v1/integration/webhook-events
Authorization: Bearer eudr_live_your_token
Content-Type: application/json

{
  "url": "https://your-server.com/webhooks/eudr",
  "events": ["supplier.created", "supplier.updated", "sync.completed"]
}

Response includes a secret for signature verification:

{
  "id": "wh_abc123",
  "url": "https://your-server.com/webhooks/eudr",
  "events": ["supplier.created", "supplier.updated", "sync.completed"],
  "active": true,
  "secret": "whsec_...",
  "createdAt": "2024-01-15T10:00:00.000Z"
}

Via Platform UI

Navigate to Integrations → Webhooks, select your integration, and click Add Webhook.

Webhook Payload

Every webhook delivery includes:

{
  "event": "supplier.created",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "integrationId": "int_abc123",
  "data": {
    "externalId": "VENDOR-001",
    "internalId": "clx..."
  }
}

Headers

Header	Description
Content-Type	application/json
X-Webhook-Signature	HMAC-SHA256 signature for verification
X-Webhook-Event	Event type (e.g., supplier.created)
X-Webhook-Id	Webhook endpoint ID
X-Webhook-Timestamp	ISO timestamp of the event
User-Agent	EUDR-Platform-Webhook/1.0

Retry Policy

• 3 retry attempts on failure
• Delays: 1 second, 5 seconds, 30 seconds
• A 2xx response resets the failure counter
• After 10 consecutive failures, the webhook is automatically disabled

Timeout

Your endpoint must respond within 10 seconds. Slow responses are treated as failures.