Webhooks

Subscribe to real-time event notifications from WISEPIM.

How webhooks work

1. Register a webhook URL via the API or dashboard
2. Select which events you want to receive
3. WISEPIM sends a POST request to your URL when events occur
4. Verify the signature using your webhook secret
5. Respond with 200 OK to acknowledge receipt

Payload Format

{
  "event": "product.enriched",
  "timestamp": "2026-03-29T10:05:00Z",
  "data": {
    "product_id": 1,
    "sku": "PROD-001",
    "enriched_fields": ["description", "meta_title"],
    "locale": "en"
  },
  "webhook_id": "wh-abc123"
}

Event Types

Products

product.createdA new product was added to the catalog

product.updatedProduct fields were modified

product.deletedA product was removed from the catalog

product.enrichedAI enrichment completed for a product

product.translatedTranslation completed for a product

Integrations

sync.startedIntegration sync has begun

sync.completedIntegration sync finished successfully

sync.failedIntegration sync encountered an error

Exports

export.completedProduct export is ready for download

import.completedProduct import finished processing

Retry Policy

If your endpoint returns a non-2xx status code or times out (30 seconds), we retry with exponential backoff:

Retry 1: 1 min

Retry 2: 5 min

Retry 3: 30 min

Retry 4: 2 hours

Retry 5: 24 hours

After 5 failed attempts, the webhook is paused. Re-activate it from the dashboard.