Send notifications from your Paragon project into your logging, analytics, and APM services.
Note: This feature is only available to Admin users. Learn more.
Event Destinations allow you to configure notifications for events that occur in your Paragon project.For example, if you’d like to add another email to be notified by email when a workflow fails, you can add an Email Destination. If you prefer notifications via Slack, you can configure a Webhook Destination to a Slack incoming webhook.You can find your project’s Event Destinations by navigating to the global Settings tab in the left sidebar and selecting Monitoring under your Project Settings.
From this Monitoring page, you can take any of the following actions for any Event Destination:
Update the configuration of the Event Destination (such as changing the email address or webhook URL)
Disable the Event Destination, which temporarily pauses notifications sent to this destination
Webhook Destinations are available for Paragon customers on paid plans. To learn more, contact our team at [email protected].
Webhook Destinations allow you to receive event notifications from your Paragon project via HTTP requests. Webhook Destinations will receive a POST request when the event occurs, with configurable request headers and body contents.
If you use Slack, Datadog, New Relic, or Sentry, you can configure a Webhook Destination by clicking “Select Template” under Request Payload and following the guide to configure below:
You can set up a Webhook Destination by following these steps:
From the Settings > Monitoring page, click the Add Destination button at the top right.
In the Type field, select Webhook (HTTP Request).
In the URL field, enter the desired URL to receive the event payload.
Optionally, in the Request Payload field, you can change the format of the payload. By default, the webhook will receive the full event object ($.event). Use {{ to specify a part of the event data to use in the request payload.
Optionally, additional request headers can be specified by expanding “Show more request options”.
Send a test request to your Webhook Destination by clicking Test Webhook button at the bottom left.
Click Save to create and enable the new destination.
Note: Your Webhook Destination may be automatically disabled if your webhook responds with too many non-2xx status codes for consecutive events.
An error occurs during the OAuth refresh process which cannot be retried. After this error, the user’s credential will be marked as invalid.Use this event to notify your user to revisit the Connect Portal in your app and re-establish the connection to the affected integration.Example webhook payload:
Copy
Ask AI
{ "type": "credentials_failure", "timestamp": 1729629449422, "timestampISO": "2024-10-22T20:37:43.849Z", "message": "Connected User “<User ID>“ credential for <Integration> expired and can not be refreshed.", "user": { "id": "<User ID>", "metadata": {} }, "project": { "id": "613b038f-e9bf-49ec-bc58-ba8d620754c7", "name": "Test Project Name" }, "integration": { "id": "57a96b31-c69e-421a-bb32-7a25f9c6a893", "type": "slack" }, "data": { "userId": "<User ID>", "error": "invalid_grant" }}
We are working on adding support for more events. Have a request for other events you’d like to send from your Paragon project? Let us know.