Prismatic Event Webhooks

A webhook is a way for an application to provide other applications with real-time information. This article covers outbound event webhooks in Prismatic - notifications you receive when events occur in your Prismatic account.

This article covers outbound webhooks

Here, we're talking about Prismatic-specific events that occur (e.g. an integration in Prismatic was published or a customer in Prismatic was updated), and you want an external app to know about that change.

If you're interested in incoming webhooks for your integrations (e.g. A Salesforce contact was updated and you want your integration's trigger to be notified), see What is a webhook?.

Why use Prismatic event webhooks?

Prismatic event webhooks allow you to stay informed about important changes and activities within your Prismatic platform. Here are some common use cases:

• Audit Trail: Keep a record of all platform changes for compliance and tracking purposes
• Monitoring & Alerting: Get notified when critical events occur, such as integrations being published or instances being deployed
• Integration with External Systems: Send Prismatic events to your monitoring tools, logging systems, or custom applications
• Real-time Updates: Receive immediate notifications instead of manually checking the web app or querying the Prismatic API

How event webhooks work

When an event occurs in your Prismatic organization, Prismatic sends a POST request to your configured webhook URL with a JSON payload containing details about the event.

Your application receives the webhook, validates it (optionally using HMAC signatures), and processes the event according to your business logic.

To get started with event webhooks, see Configuring event webhooks.

Webhook payload structure

When an event occurs, Prismatic sends a POST request to your webhook URL with a JSON payload. Here's an example of what the payload looks like:

{
  "integration": {
    "id": "SW50ZWdyYXRpb246ZWM5YzViM2EtZjNhNy00MDliLTllM2QtODA3MDAxNDVlNWU0",
    "name": "Slack Integration",
    "description": "Get alerts in Slack when new contacts are created",
    "category": "Communication",
    "has_unpublished_changes": false,
    "version_number": 6,
    "created_at": "2025-08-21T20:22:54.828609+00:00",
    "updated_at": "2025-08-21T20:22:54.828609+00:00"
  },
  "customer": null,
  "parent_integration": null,
  "user": {
    "id": "VXNlcjoyMzZkMDA3ZS0zZGIxLTQ4MWItOTMyNS0zMjhhYTE0OTY5MDA=",
    "email": "user@example.com",
    "name": "John Doe"
  },
  "event_type": "integration.published",
  "timestamp": "2025-08-21T20:22:57.855591+00:00",
  "organization_id": "T3JnYW5pemF0aW9uOmJjYjE0NjEzLTNjZTItNGQ0MC04OTZmLTIyNTZiNjcyYTllYw==",
  "webhook_id": "c1e226a7-8d13-4d46-98d9-a99a2d6bdb37"
}

Payload fields

Field	Description
event_type	The type of event that occurred (e.g., integration.published)
timestamp	When the event occurred (ISO 8601 format)
webhook_id	Unique identifier for the webhook that sent this notification
organization_id	Your Prismatic organization ID
user	Information about the user who triggered the event (if applicable)
integration	Integration details (for integration-related events)
customer	Customer details (for customer-related events)
instance	Instance details (for instance-related events)
workflow	Workflow details (for workflow-related events)
component	Component details (for component-related events)
connection	Connection details (for connection-related events)
alert_monitor	Alert monitor details (for alert-related events)
alert_group	Alert group details (for alert group events)
log_stream	Log stream details (for log stream events)

Available event types

Prismatic provides comprehensive coverage of platform events. Here's a complete list of available event types:

Instance events

Event	ID	Description
Instance Created	instance.created	Triggered when a new integration instance is created
Instance Updated	instance.updated	Triggered when an instance's configuration is modified
Instance Deleted	instance.deleted	Triggered when an instance is removed from the platform
Instance Deployed	instance.deployed	Triggered when an instance is successfully deployed
Instance Enabled	instance.enabled	Triggered when an instance is activated
Instance Disabled	instance.disabled	Triggered when an instance is deactivated

Customer events

Event	ID	Description
Customer Created	customer.created	Triggered when a new customer is added to your platform
Customer Updated	customer.updated	Triggered when customer information is modified
Customer Deleted	customer.deleted	Triggered when a customer is removed from the platform

User events

Event	ID	Description
User Created	user.created	Triggered when a new user account is created
User Updated	user.updated	Triggered when user profile information is modified
User Deleted	user.deleted	Triggered when a user account is removed

Integration events

Event	ID	Description
Integration Created	integration.created	Triggered when a new integration is created
Integration Updated	integration.updated	Triggered when integration configuration is modified
Integration Deleted	integration.deleted	Triggered when an integration is removed
Integration Published	integration.published	Triggered when an integration is published to the marketplace

Workflow events

Event	ID	Description
Workflow Created	workflow.created	Triggered when a new workflow is created within an integration
Workflow Updated	workflow.updated	Triggered when workflow configuration is modified
Workflow Deleted	workflow.deleted	Triggered when a workflow is removed
Workflow Published	workflow.published	Triggered when a workflow is published
Workflow Enabled	workflow.enabled	Triggered when a workflow is activated
Workflow Disabled	workflow.disabled	Triggered when a workflow is deactivated

Component events

Event	ID	Description
Component Deleted	component.deleted	Triggered when a custom component is removed
Component Published	component.published	Triggered when a component is published to the marketplace

Connection events

Event	ID	Description
Connection Updated	connection.updated	Triggered when connection configuration is modified
Connection Deleted	connection.deleted	Triggered when a connection is removed

Alert & monitoring events

Event	ID	Description
Alert Monitor Created	alert_monitor.created	Triggered when a new alert monitor is configured
Alert Monitor Updated	alert_monitor.updated	Triggered when alert monitor settings are modified
Alert Monitor Deleted	alert_monitor.deleted	Triggered when an alert monitor is removed
Alert Group Created	alert_group.created	Triggered when a new alert group is created
Alert Group Updated	alert_group.updated	Triggered when alert group configuration is modified
Alert Group Deleted	alert_group.deleted	Triggered when an alert group is removed

Log stream events

Event	ID	Description
Log Stream Created	log_stream.created	Triggered when a new log stream is configured
Log Stream Updated	log_stream.updated	Triggered when log stream settings are modified
Log Stream Deleted	log_stream.deleted	Triggered when a log stream is removed

OAuth2 events

Event	ID	Description
OAuth2 Authorization Completed	oauth2.authorization_completed	Triggered when OAuth2 authorization is successfully completed
OAuth2 Authorization Failed	oauth2.authorization_failed	Triggered when OAuth2 authorization fails
OAuth2 Token Refreshed	oauth2.token_refreshed	Triggered when an OAuth2 token is successfully refreshed
OAuth2 Token Refresh Failed	oauth2.token_refresh_failed	Triggered when OAuth2 token refresh fails

System events

Event	ID	Description
Test	webhook.test	Triggered when testing a webhook configuration

Next steps

• Configure event webhooks to start receiving notifications
• Prismatic Insider: Subscribing to Events with Prismatic's API and Event Webhooks
• Example Node.js Express Webhook Receiver