clay-incident-runbook

name	clay-incident-runbook
description	Execute Clay incident response procedures for enrichment failures, credit exhaustion, and data flow outages. Use when Clay enrichments stop working, webhook delivery fails, or CRM sync breaks in production. Trigger with phrases like "clay incident", "clay outage", "clay down", "clay emergency", "clay broken", "clay enrichment stopped".
allowed-tools	Read, Grep, Bash(curl:*)
version	1.0.0
license	MIT
author	Jeremy Longshore <[e-mail]>
compatible-with	claude-code, codex, openclaw
tags	["saas","clay","incident-response"]

Clay Incident Runbook

Overview

Rapid response procedures for Clay-related production incidents. Clay is a hosted SaaS platform, so incidents fall into two categories: (1) Clay-side issues (platform outage, provider degradation) and (2) your-side issues (webhook misconfiguration, credit exhaustion, handler failures).

Severity Levels

Level	Definition	Response Time	Examples
P1	Complete data flow stopped	< 15 min	Credits exhausted, webhook URL expired, Clay outage
P2	Degraded enrichment	< 1 hour	Low hit rates, slow processing, CRM sync errors
P3	Minor impact	< 4 hours	Single provider down, intermittent webhook failures
P4	No user impact	Next business day	Monitoring gaps, cost optimization needed

Instructions

Step 1: Quick Triage (2 Minutes)

#!/bin/bash
# clay-triage.sh — rapid diagnostic for Clay incidents
set -euo pipefail

echo "=== Clay Incident Triage ==="
echo "Time: $(date -u +%Y-%m-%dT%H:%M:%SZ)"
echo ""

# 1. Check Clay platform status
echo "--- Clay Platform Status ---"
curl -s -o /dev/null -w "clay.com: HTTP %{http_code}\n" https://www.clay.com
echo ""

# 2. Test webhook delivery
echo "--- Webhook Test ---"
if [ -n "${CLAY_WEBHOOK_URL:-}" ]; then
  WEBHOOK_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
    -X POST "$CLAY_WEBHOOK_URL" \
    -H  \
    -d $( -u +%s))
   
   [  =  ];   ; 
   [  =  ];   ; 
   [  =  ];   ; 

   

 


 
 [ -n  ]; 
  API_CODE=$(curl -s -o /dev/null -w  \
    -X POST  \
    -H  \
    -H  \
    -d )
   
   [  =  ];   ; 
   [  =  ];   ; 

   

 


 
CALLBACK_URL=
curl -s -o /dev/null -w   ||