1. Integrations
  2. Events

Integrations

Events

Integration error events are emitted when error counts exceed the organization's configured thresholds. Unlike standard events, these are internal notification events and are not dispatched to webhook endpoints. They are used exclusively to trigger email notifications to subscribed users.

Outgoing Integration Events

Event Description
outgoing_integration__error Outgoing integration errors exceeded the configured failure_limit within the interval

Event Data

The event payload contains the full outgoing integration record plus an error_notification object with threshold details.

        {
  "object": "outgoing_integration",
  "id": "01961e2a-5b0c-7f00-8a3e-abc123def456",
  "organization_id": "org_xyz789",
  "integration": "netsuite",
  "resource": "fulfillment",
  "resource_id": "ful_abc123",
  "has_errors": true,
  "errors": [...],
  "error_notification": {
    "count": 5,
    "limit": 3,
    "created_at": "2026-03-06T12:00:00.000Z"
  }
}

      
Field Type Description
object string Always "outgoing_integration"
id string The ID of the outgoing integration record that triggered the event
organization_id string The organization where the errors occurred
error_notification.count integer The total number of errors counted in the current interval
error_notification.limit integer The configured failure limit that was exceeded
error_notification.created_at string ISO 8601 timestamp when the notification was triggered

All other fields from the outgoing integration record are also included (e.g., integration, resource, resource_id, has_errors, errors, payload, etc.).

Incoming Webhook Events

Event Description
incoming_webhook__error Incoming webhook errors exceeded the configured failure_limit within the interval

Event Data

The event payload contains the full incoming webhook record plus an error_notification object with threshold details.

        {
  "object": "incoming_webhook",
  "id": "iw_netsuite_abc123",
  "service": "netsuite",
  "has_errors": true,
  "errors": [...],
  "error_notification": {
    "count": 10,
    "limit": 5,
    "created_at": "2026-03-06T12:00:00.000Z"
  }
}

      
Field Type Description
object string Always "incoming_webhook"
id string The ID of the incoming webhook record that triggered the event
service string The service that sent the webhook (e.g., "netsuite")
error_notification.count integer The total number of errors counted in the current interval
error_notification.limit integer The configured failure limit that was exceeded
error_notification.created_at string ISO 8601 timestamp when the notification was triggered

All other fields from the incoming webhook record are also included (e.g., service, has_errors, errors, payload, etc.).