Email

An email channel sends notifications to a list of addresses. Create one channel per audience, for example one for the data team and one for on-call.

Create an email channel

Go to Settings > Notifications.
Under Channels, select Create channel and choose Email.
Add one or more recipients. If you add several, give the group a name.
Save the channel.

Single recipient
Group of recipients

The Create channel dialog with Email selected and one recipient address

You can also create a channel while you add a notification. Then subscribe the channel to events for the team or for one workflow. See Notifications in the UI.

Set up with code

EMAIL: true sends to your account email. Pass recipients to send to other addresses.

import { KadoaClient } from "@kadoa/node-sdk";

const client = new KadoaClient({ apiKey: "YOUR_API_KEY" });

// Use your account email
await client.notification.setupForWorkflow({
  workflowId: "YOUR_WORKFLOW_ID",
  events: ["workflow_finished", "workflow_failed"],
  channels: { EMAIL: true },
});

// Or specify custom recipients
await client.notification.setupForWorkflow({
  workflowId: "YOUR_WORKFLOW_ID",
  events: ["workflow_data_change"],
  channels: {
    EMAIL: {
      name: "team-alerts",
      recipients: ["team@company.com", "alerts@company.com"],
    },
  },
});

from kadoa_sdk import KadoaClient, KadoaClientConfig
from kadoa_sdk.notifications import SetupWorkflowNotificationSettingsRequest

client = KadoaClient(KadoaClientConfig(api_key="YOUR_API_KEY"))

# Use your account email
client.notification.setup_for_workflow(
    SetupWorkflowNotificationSettingsRequest(
        workflow_id="YOUR_WORKFLOW_ID",
        events=["workflow_finished", "workflow_failed"],
        channels={"EMAIL": True},
    )
)

# Or specify custom recipients
client.notification.setup_for_workflow(
    SetupWorkflowNotificationSettingsRequest(
        workflow_id="YOUR_WORKFLOW_ID",
        events=["workflow_data_change"],
        channels={
            "EMAIL": {
                "name": "team-alerts",
                "recipients": ["team@company.com", "alerts@company.com"],
            }
        },
    )
)

For the REST API, see Create notification channel.

What each email contains

Each event type has its own email layout. Data change emails can also include an AI summary and a CSV attachment. Choose these under notification content.

workflow_data_change
workflow_finished
workflow_failed
workflow_data_quality_change

System emails

Kadoa sends these emails automatically. You cannot turn them off.

workflow_sample_finished

Sent to the workflow author when preview data is ready for review.

Get started

Concepts

Security & Compliance

Build workflows

Templates

Monitor & alert

MCP

Integrations

Administration

Create an email channel

Set up with code

What each email contains

System emails

​Create an email channel

​Set up with code

​What each email contains

​System emails

Create an email channel

Set up with code

What each email contains

System emails