> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kadoa.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Email
> Receive email notifications when workflow events occur
## Setup
```typescript title="Node SDK" theme={null}
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"],
},
},
});
```
```python title="Python SDK" theme={null}
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 API configuration, see the [API reference](/api-reference/notifications).
### Dashboard Setup
1. Go to **Notifications** in the sidebar
2. Click **Add Channel** → **Email**
3. Add a single or group of recipient email addresses
4. Save changes
## Email Templates
Each event type has a dedicated email template with relevant information.
## System Emails
These emails are sent automatically and cannot be configured.
Sent to the workflow author when sample data is ready for review.
