Zapier Integration Guide

Connect SCBE alerts to Slack, Email, Notion, and 5000+ other apps via Zapier.

Overview

┌─────────────────────────────────────────────────────────────────┐
│                    SCBE → ZAPIER → YOUR APPS                    │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│   SCBE API                                                       │
│      │                                                          │
│      │ DENY or QUARANTINE decision                              │
│      │                                                          │
│      ▼                                                          │
│   /v1/alerts  ◀──── Zapier polls every 1-5 minutes              │
│      │                                                          │
│      │ New alert detected                                       │
│      │                                                          │
│      ▼                                                          │
│   ┌─────────────────────────────────────────────────────────┐   │
│   │                      ZAPIER                              │   │
│   │                                                          │   │
│   │   ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐   │   │
│   │   │  Slack  │  │  Email  │  │ Notion  │  │ PagerDuty│  │   │
│   │   └─────────┘  └─────────┘  └─────────┘  └─────────┘   │   │
│   │                                                          │   │
│   └─────────────────────────────────────────────────────────┘   │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Quick Setup: SCBE → Slack

Step 1: Create Zap

Go to zapier.com and log in
Click “Create Zap”

Step 2: Set Trigger (SCBE Alerts)

Search for “Webhooks by Zapier”
Choose “Retrieve Poll” as trigger
Configure:
- URL: https://your-scbe-api.com/v1/alerts?pending_only=true
- Headers:
```
X-API-Key: your-scbe-api-key
```

Step 3: Set Action (Slack Message)

Search for “Slack”
Choose “Send Channel Message”
Connect your Slack workspace
Configure message:

🚨 SCBE Alert: 

Agent: 
Decision: 
Message: 

Trust Score: 
Audit ID: 
Time: 

Step 4: Test & Enable

Click “Test trigger” to pull sample data
Review the Slack message preview
Click “Publish Zap”

Quick Setup: SCBE → Email

Trigger

Same as above - use “Webhooks by Zapier” → “Retrieve Poll”

Action: Gmail/Email

Search for “Gmail” (or your email provider)
Choose “Send Email”
Configure:
- To: security-team@yourcompany.com
- Subject: [SCBE ] -
- Body:

<h2>SCBE Security Alert</h2>

<table>
  <tr><td><b>Severity:</b></td><td></td></tr>
  <tr><td><b>Agent:</b></td><td></td></tr>
  <tr><td><b>Decision:</b></td><td></td></tr>
  <tr><td><b>Trust Score:</b></td><td></td></tr>
  <tr><td><b>Time:</b></td><td></td></tr>
</table>

<p></p>

<p><a href="https://your-scbe-dashboard.com/audit/">View Full Audit</a></p>

Quick Setup: SCBE → Notion

Action: Create Database Item

Search for “Notion”
Choose “Create Database Item”
Select your alerts database
Map fields:
- Alert ID: ``
- Severity: ``
- Agent: ``
- Message: ``
- Timestamp: ``
- Status: “New”

Alert Data Structure

Each alert from /v1/alerts includes:

{
  "alert_id": "alert-20260123-143052-a1b2c3",
  "timestamp": "2026-01-23T14:30:52.123456Z",
  "severity": "high",
  "alert_type": "decision_deny",
  "message": "Agent trading-bot-001 request was DENY: execute_trade",
  "agent_id": "trading-bot-001",
  "audit_id": "audit-20260123-143052-xyz789",
  "data": {
    "trust_score": 0.25,
    "risk_level": "HIGH"
  }
}

Field Reference

Field	Description	Example Values
`severity`	Alert importance	`low`, `medium`, `high`, `critical`
`alert_type`	What triggered alert	`decision_deny`, `decision_quarantine`, `trust_decline`
`agent_id`	AI agent identifier	`trading-bot-001`
`audit_id`	Link to full audit	`audit-20260123-...`
`data.trust_score`	Agent’s trust score	`0.0` - `1.0`

Advanced: Filtered Alerts

Only trigger on specific conditions:

High Severity Only

Add a Filter step in Zapier:

Field: severity
Condition: (Text) Exactly matches
Value: high

Specific Agent

Add a Filter step:

Field: agent_id
Condition: (Text) Contains
Value: trading

Acknowledging Alerts

After processing, acknowledge alerts so they don’t repeat:

Option 1: Zapier Webhook Action

Add a second action after your notification:

“Webhooks by Zapier” → “POST”
URL: https://your-scbe-api.com/v1/alerts//ack
Headers: X-API-Key: your-key

Option 2: Let Them Auto-Expire

Alerts older than 24 hours are automatically marked as processed.

Pre-Built Zap Templates

Copy these templates (replace URLs and keys):

Slack Critical Alerts

Trigger: Webhooks by Zapier (Poll)
  URL: https://api.example.com/v1/alerts?pending_only=true
  Headers: X-API-Key: xxx

Filter: severity = high OR severity = critical

Action: Slack - Send Channel Message
  Channel: #security-alerts
  Message: 🚨 ** | 

Daily Notion Summary

Trigger: Schedule by Zapier
  Every day at 9:00 AM

Action: Webhooks by Zapier (GET)
  URL: https://api.example.com/v1/metrics
  Headers: X-API-Key: xxx

Action: Notion - Create Database Item
  Title: SCBE Daily Report - 
  Allow Rate: 
  Deny Rate: 
  Total: 

Troubleshooting

“No new data” in trigger test

Generate a test alert:

curl -X POST https://your-api.com/v1/authorize \
  -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"test","action":"test","target":"test","context":{"sensitivity":0.9}}'

Wait 30 seconds, test trigger again

Duplicate alerts

Make sure to add the acknowledge step after your notification action.

Rate limiting

Zapier polls every 1-15 minutes. For real-time alerts, consider:

Upgrading to Zapier premium (instant triggers)
Using SCBE webhooks directly (coming soon)