Alerts
Use these endpoints to manage email alerts that fire when a goal is reached.
Alerts are useful for founder workflows, sales notifications, and agent monitoring. An alert watches one goal and sends an email when that goal is triggered. History lets you inspect recent sent and failed alerts.
Base path:
https://datafa.st/api/v1/admin| Endpoint | Method | Path | Permission | Purpose |
|---|---|---|---|---|
| List alerts | GET | /websites/{websiteId}/alerts | alerts:read | List alerts |
| Create alert | POST | /websites/{websiteId}/alerts | alerts:write | Create an alert |
| Update alert | PUT | /websites/{websiteId}/alerts/{alertId} | alerts:write | Update an alert |
| Delete alert | DELETE | /websites/{websiteId}/alerts/{alertId} | alerts:write | Delete an alert |
| Get alert history | GET | /websites/{websiteId}/alerts/history | alerts:read | Get recent alert trigger history |
Create an alert
curl -X POST "https://datafa.st/api/v1/admin/websites/YOUR_WEBSITE_ID/alerts" \
-H "Authorization: Bearer dft_xxx" \
-H "Content-Type: application/json" \
-d '{
"name": "New signup",
"trigger": { "goalName": "signup" },
"template": {
"subject": "New signup",
"message": "A visitor completed signup."
},
"isEnabled": true
}'
Alert history supports
alertId and limit query parameters:GET /api/v1/admin/websites/{websiteId}/alerts/history?alertId={alertId}&limit=50