enonic-webhook-integrator

Automate Enonic XP content lifecycle integrations via outbound webhooks and inbound HTTP endpoints.

1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/webmaxru/enonic-agent-skills --skill enonic-webhook-integrator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: enonic-webhook-integrator
Source: https://github.com/webmaxru/enonic-agent-skills/tree/main/skills/enonic-webhook-integrator
Command: npx skills add https://github.com/webmaxru/enonic-agent-skills --skill enonic-webhook-integrator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Enonic XP teams often need to wire event listeners, outbound webhooks, and inbound HTTP endpoints to automate content lifecycle integrations. This Skill provides a cohesive pattern for setting up lib-event listeners, configuring outbound webhooks via com.enonic.xp.webhooks.cfg, and exposing inbound HTTP services to handle external payloads, reducing manual wiring and increasing reliability.

Core Features & Use Cases

  • Event listener setup: Registers Enonic XP event listeners to react to content lifecycle changes.
  • Outbound webhooks: Configures and fires HTTPS POSTs to external systems when events occur.
  • Inbound HTTP service endpoints: Provides scaffolding for inbound webhook processing and content orchestration.
  • Security and best practices: Includes API key/HMAC authentication, payload sanitization, and secret handling guidance for production deployments.
  • Use cases: Notifies Slack or CDN providers on publish, synchronizes search indexes, or routes content changes to external systems for downstream processing.

Quick Start

Use the webhook integration to bootstrap outbound inbound handling by wiring event listeners, configuring webhooks in XP_HOME/config/com.enonic.xp.webhooks.cfg, and implementing a matching inbound service at src/main/resources/services.

Frequently Asked Questions about enonic-webhook-integrator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure outbound webhooks in Enonic XP for content lifecycle events?

To configure outbound webhooks in Enonic XP, you register event listeners for content lifecycle changes and fire HTTPS POSTs to external systems using the com.enonic.xp.webhook.cfg configuration file. This automates notifications for publish, update, and delete events.

What is the best way to handle inbound HTTP endpoints for external payloads in Enonic XP?

Handling inbound HTTP endpoints in Enonic XP involves implementing a matching inbound service at src/main/resources/services. This provides scaffolding to process external payloads and orchestrate content updates bi-directionally.

Can I use Enonic XP webhooks to notify Slack or sync search indexes on publish?

Yes, you can use Enonic XP webhooks to notify Slack or CDN providers on publish, synchronize search indexes, or route content changes to external systems for downstream processing when content lifecycle events occur.

Does the Enonic XP webhook integration support security and API key authentication?

Yes, Enonic XP webhook integration supports security best practices including API key and HMAC authentication, payload sanitization, and secret handling guidance to ensure production-ready deployments.

How do Enonic XP event listeners work with lib-event and lib-task for asynchronous automation?

Enonic XP event listeners work with lib-event to react to content lifecycle changes, while lib-task manages asynchronous work and lib-httpClient fires outbound webhooks, ensuring reliable event-driven automation without blocking.

Why do I need bi-directional webhook integration for Enonic XP content updates?

You need bi-directional webhook integration in Enonic XP to automate both outbound notifications when content changes and inbound HTTP endpoints to receive external payloads, reducing manual wiring and increasing content orchestration reliability.