Payload Transformations

Payload transformations let you filter or modify webhook events before they are delivered. The transformation runs inside Paradime, so if you cancel the event, no request is sent to your destination.

When to use transformations

Use a transformation to suppress webhook deliveries you don’t need to act on. Two common cases:

Case	Why skip it
`bolt.run.completed` with `status: "passed"`	Only failures need alerting
Turbo CI runs (`schedule.turbo_ci` is non-null)	CI jobs are not production schedule failures

Example: Skip passed runs and Turbo CI

The handler below cancels delivery for both categories above.

function handler(webhook) {
  var payload = webhook.payload;

  // Skip passed runs (only failed runs need alerting)
  if (payload.status === "passed") {
    webhook.cancel = true;
    return webhook;
  }

  // Skip Turbo CI jobs (these are CI runs, not production schedule failures)
  if (payload.schedule && payload.schedule.turbo_ci !== null) {
    webhook.cancel = true;
    return webhook;
  }

  return webhook;
}

Setting webhook.cancel = true stops delivery entirely. The event is dropped, so no HTTP request is made to your endpoint.

How to apply a transformation

Go to Webhooks and click the webhook you want to configure.
Open the Advanced tab.
Toggle Enable transformation on.
Click Edit transformation and paste your handler function.
Save.

Tip: Changes take effect immediately on the next event. Test with a manual run before relying on it in production.

API Keys & Access

GraphQL API

Python SDK

Paradime CLI

Webhooks

Virtual Environments

Payload Transformations

When to use transformations

Example: Skip passed runs and Turbo CI

How to apply a transformation

​When to use transformations

​Example: Skip passed runs and Turbo CI

​How to apply a transformation

When to use transformations

Example: Skip passed runs and Turbo CI

How to apply a transformation