Webhook - Fiddler Documentation

Webhook for integrating external notification systems with Fiddler alerts. A Webhook represents an integration endpoint for delivering alert notifications to external systems like Slack, Microsoft Teams, or custom HTTP endpoints. Webhooks enable real-time alert delivery to team communication tools.

name

Human-readable name for the webhook. Should be descriptive and indicate the target system or team.

url

The webhook endpoint URL provided by the external system. This is the destination where alert notifications will be sent.

provider

The webhook provider type (WebhookProvider). Determines message formatting and delivery method.

Example

# Create Slack webhook for critical alerts
slack_webhook = Webhook(
    name="critical-alerts-slack",
    url="https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX",
    provider=WebhookProvider.SLACK
).create()

# Create Microsoft Teams webhook for team notifications
teams_webhook = Webhook(
    name="ml-team-notifications",
    url="https://outlook.office.com/webhook/xxxxx/IncomingWebhook/xxxxx",
    provider=WebhookProvider.MS_TEAMS
).create()

# List all webhooks
webhooks = list(Webhook.list())
for webhook in webhooks:

    print(f"Webhook: {webhook.name} ({webhook.provider})")

    # Update webhook URL
    webhook = Webhook.from_name("critical-alerts-slack")
    webhook.url = "https://hooks.slack.com/services/NEW/WEBHOOK/URL"
    webhook.update()

Webhook URLs are sensitive credentials that should be kept secure. The provider type determines how messages are formatted and delivered. Test webhooks thoroughly before using them in production alert rules.

Initialize a Webhook instance. Creates a webhook configuration for integrating external notification systems with Fiddler alert notifications. The webhook defines where and how alert messages should be delivered to external platforms.

Parameters

name

str

required

Human-readable name for the webhook. Should be descriptive and indicate the target system, team, or purpose (e.g., “ml-team-slack”, “critical-alerts-teams”).

url

str

required

The webhook endpoint URL provided by the external system. This is the destination where Fiddler will send HTTP POST requests with alert notification payloads.

provider

WebhookProvider | str

required

The webhook provider type (SLACK, MS_TEAMS, or GENERIC). Determines message formatting, payload structure, and delivery method for optimal integration with the target platform.

Example

# Slack webhook for ML team alerts
slack_webhook = Webhook(
    name="ml-team-slack-alerts",
    url="https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX",
    provider=WebhookProvider.SLACK
)

# Microsoft Teams webhook for data quality alerts
teams_webhook = Webhook(
    name="data-quality-teams",
    url="https://outlook.office.com/webhook/xxxxx/IncomingWebhook/xxxxx",
    provider=WebhookProvider.MS_TEAMS
)

# Generic webhook for custom integrations
custom_webhook = Webhook(
    name="custom-monitoring-system",
    url="https://monitoring.company.com/webhooks/fiddler",
    provider=WebhookProvider.GENERIC
)

After initialization, call create() to register the webhook with the Fiddler platform. Webhook URLs are sensitive and should be kept secure.

classmethod get()

Get the webhook instance using webhook id

Params uuid: UUID belongs to the Webhook

Returns

Webhook object

classmethod from_name()

Get the webhook instance using webhook name

Returns

Webhook

classmethod list()

Get a list of all webhooks in the organization

Returns

Iterator[Webhook]

create()

Create a new webhook

Params name: name of webhook
Params url: webhook url
Params provider: Either ‘SLACK’ or ‘MS_TEAMS’

Returns

Created Webhook object.

update()

Update an existing webhook.

delete()

Delete an existing webhook.

​name

​url

​provider

​Example

​Parameters

​Example

​classmethod get()

​Returns

​classmethod from_name()

​Returns

​classmethod list()

​Returns

​create()

​Returns

​update()

​delete()

name

url

provider

Example

Parameters

Example

classmethod get()

Returns

classmethod from_name()

Returns

classmethod list()

Returns

create()

Returns

update()

delete()