Developer Portal

Webhooks

Subscribe to real-time event notifications from WISEPIM.

How webhooks work

  1. 1. Register a webhook URL via the API or dashboard
  2. 2. Select which events you want to receive
  3. 3. WISEPIM sends a POST request to your URL when events occur
  4. 4. Verify the signature using your webhook secret
  5. 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

Categories

category.createdA new category was created
category.updatedCategory details were modified
category.deletedA category was removed

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.