Event Hooks

Event Hooks are outbound webhooks that fire when something happens in your project—such as an entry being published or a workflow transition. Each hook runs an action that either sends an HTTP request to a URL you specify or posts a message to a Slack channel.

Use Event Hooks to integrate Contismo with external systems: invalidate caches, sync data to other platforms, trigger builds, or notify your team in Slack.

Create an Event Hook

1. Go to Settings → Event Hooks.
2. Click Create Event Hook.
3. Enter a name that identifies what the hook does.
4. Choose a Trigger (see the table below).
5. Optionally limit the hook to specific content models.
6. Choose an Action — HTTP or Slack.
7. Configure the action details and save.

Creating and managing Event Hooks requires the appropriate webhook permissions on your role.

Triggers

| Trigger | Fires when | | ------- | ---------- | | Entry Created | A new entry is created. | | Entry Updated | An existing entry is saved. | | Entry Published | An entry goes live. | | Entry Unpublished | A live entry is taken offline. | | Entry Moved to Trash | An entry is deleted (moved to trash). | | Entry Restored | A trashed entry is restored. | | Entry Permanently Deleted | An entry is permanently removed from trash. | | Workflow Transitioned | An entry moves to a new workflow state. |

You can optionally restrict a hook to one or more content models so it only fires for matching entries.

HTTP Actions

An HTTP action sends a request to a URL you provide when the trigger fires.

Configure:

• URL — the endpoint that receives the request.
• Method — POST, PUT, or PATCH.
• Headers — custom headers sent with the request. Mark sensitive values as secret to store them encrypted.
• Signing Secret (optional) — when set, requests include an X-EventHook-Signature header with an HMAC-SHA256 signature your endpoint can verify.

Your endpoint should respond with a success status code. Failed deliveries are recorded in the hook’s delivery log.

Slack Actions

A Slack action posts a formatted message to a Slack channel when the trigger fires.

Before you can use a Slack action:

1. Connect Slack for the project — see Slack.
2. When creating the Event Hook, choose Slack as the action and select a channel.

Private channels

For private channels, invite the Contismo app to the channel in Slack before selecting it on the Event Hook. The app must be a member of the channel to view and post messages there.

Delivery Logs

Each Event Hook has a delivery log showing recent attempts—whether they succeeded or failed. From the Event Hooks list, click View Logs on a hook to inspect individual deliveries.

Use logs to debug integration issues, such as incorrect URLs, authentication failures, or Slack channels that are no longer available.

Permissions

Event Hooks are managed under Settings → Developers. Team members need webhook capabilities to list, create, update, or delete hooks. Slack actions additionally require Slack to be connected by someone with the Manage Integrations permission.

Related

• Slack — connect a Slack workspace for Slack actions.