clay-advanced-troubleshooting

# Clay Advanced Troubleshooting ## Overview Deep debugging techniques for complex Clay issues that resist standard troubleshooting. Covers provider-level isolation, waterfall diagnosis, HTTP API column debugging, Claygent failure analysis, and Clay support escalation with proper evidence. ## Prerequisites - Access to Clay table with the failing enrichments - curl and jq for API testing - Understanding of Clay's enrichment architecture (providers, waterfall, columns) - Browser developer tools for network inspection ## Instructions ### Step 1: Isolate the Failure Layer ```bash #!/bin/bash # clay-layer-test.sh — test each integration layer independently set -euo pipefail echo "=== Layer Isolation Test ===" # Layer 1: Webhook delivery echo "Layer 1: Webhook" WEBHOOK_CODE=$(curl -s -o /dev/null -w "%{http_code}" \ -X POST "$CLAY_WEBHOOK_URL" \ -H "Content-Type: application/json" \ -d '{"_debug": true, "domain": "google.com"}') echo " Webhook: $WEBHOOK_CODE" # Layer 2: Enterprise API (if applicable) if [ -n "${CLAY_API_KEY:-}" ]; then echo "Layer 2: Enterprise API" API_RESULT=$(curl -s -X POST "https://api.clay.com/v1/companies/enrich" \ -H "Authorization: Bearer $CLAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain": "google.com"}') echo " API response keys: $(echo "$API_RESULT" | jq 'keys')" fi # Layer 3: HTTP API callback endpoint echo "Layer 3: Callback endpoint" CALLBACK_CODE=$(curl -s -o /dev/null -w "%{http_code}" \ -X POS...