Send webhook events to an OpenTelemetry Collector

​

Prerequisites

• An OpenTelemetry-compatible traces endpoint
• Any authentication headers required by the collector or observability provider
• Permission to manage webhook endpoints in the Novu environment

​

Configuration

​

Transformation contract

• input.events, an array whose length is capped by the endpoint batch size
• input.events[].eventType, the Novu event type, for example message.sent
• input.events[].payload, the webhook body

{
  config: {
    serviceName: string;
    scope: {
      name: string;
      version: string;
    };
  };
  spans: Array<{
    startTime: string;
    endTime: string;
    name: string;
    kind?: "SERVER" | "CLIENT" | "PRODUCER" | "CONSUMER" | "INTERNAL";
    attributes?: Record<string, unknown>;
    traceIdKey?: string;
    spanIdKey?: string;
    parentSpanIdKey?: string;
  }>;
}

function handler(input) {
  const spans = input.events.map((event) => {
    const timestamp = new Date().toISOString();

    return {
      startTime: timestamp,
      endTime: timestamp,
      name: event.eventType,
      attributes: event.payload,
    };
  });

  return {
    config: {
      serviceName: "novu.webhooks",
      scope: {
        name: "novu.webhooks",
        version: "1.0.0",
      },
    },
    spans,
  };
}

​

Configure in the Dashboard

​

Verify delivery

​

Troubleshooting

• The collector returns an HTTP error: Confirm the URL is an OTLP HTTP traces endpoint and includes /v1/traces where required.
• Authentication fails: Verify header names and values against the observability provider’s current OTLP documentation.
• No spans appear after success: Search for the configured service name and confirm the provider is reading from the same account, site, or region.
• Spans have invalid timestamps: Return ISO 8601 strings for startTime and endTime.
• Spans do not correlate: Use the same traceIdKey for related spans and match a child’s parentSpanIdKey to its parent’s spanIdKey.

​

Related

• Webhook connectors overview
• Webhook event types
• Webhook delivery, retries, and recovery

​

Official references

• Svix OpenTelemetry tracing endpoint
• Svix advanced endpoint types
• OpenTelemetry OTLP endpoint configuration