bcharleson/clay-gtm-cli/clay-suppression-check

npm install -g clay-gtm-cli
brew install cloudflared
clay tables add \
  --name suppression-check \
  --webhook-url https://app.clay.com/webhook/YOUR_WEBHOOK_ID \
  --description "Suppression/DNC check — validate before any outreach"
clay listen start

# Check a single contact
clay fire suppression-check \
  --data '{"email": "john@acme.com"}' \
  --wait
 
# Check with domain-level suppression (e.g. entire company opted out)
clay fire suppression-check \
  --data '{
    "email": "john@acme.com",
    "company_domain": "acme.com",
    "linkedin_url": "https://linkedin.com/in/jdoe"
  }' \
  --wait
 
# Batch check before a campaign launch
cat campaign_leads.json | jq -c '.[] | {email: .email, company_domain: .domain}' \
  | while read lead; do
    clay fire suppression-check --data "$lead" --wait \
      | jq 'select(.data.suppressed == true) | {email: .data.email, reason: .data.suppression_reason}'
  done

{
  "success": true,
  "table": "suppression-check",
  "data": {
    "email": "john@acme.com",
    "suppressed": false,
    "domain_suppressed": false,
    "checks_run": [
      {"list": "internal_unsubscribe", "result": "clear"},
      {"list": "global_opt_out", "result": "clear"},
      {"list": "competitor_employees", "result": "clear"},
      {"list": "existing_customers", "result": "clear"},
      {"list": "open_opportunities", "result": "clear"}
    ],
    "safe_to_contact": true,
    "suppression_reason": null
  }
}

# Always run before adding to any sequence
EMAIL="john@acme.com"
SUPPRESSED=$(clay fire suppression-check \
  --data "{\"email\":\"$EMAIL\"}" \
  --wait | jq -r '.data.suppressed')
 
if [ "$SUPPRESSED" = "false" ]; then
  echo "Clear to contact: $EMAIL"
  # Proceed with outbound-prep or sequence enrollment
else
  REASON=$(clay fire suppression-check --data "{\"email\":\"$EMAIL\"}" --wait | jq -r '.data.suppression_reason')
  echo "SUPPRESSED ($REASON): $EMAIL — skip"
fi
 
# Pre-campaign validation — flag all suppressed leads
cat campaign_list.json | jq -c '.[]' | while read lead; do
  RESULT=$(clay fire suppression-check --data "$lead" --wait)
  SUPPRESSED=$(echo $RESULT | jq -r '.data.suppressed')
  if [ "$SUPPRESSED" = "true" ]; then
    echo $RESULT | jq '{email: .data.email, reason: .data.suppression_reason}'
  fi
done
 
# Get clean count before campaign launch
TOTAL=$(wc -l < campaign_list.json)
SUPPRESSED_COUNT=$(cat campaign_list.json | jq -c '.[]' | while read lead; do
  clay fire suppression-check --data "$lead" --wait \
    | jq 'select(.data.suppressed == true)' 
done | wc -l)
echo "Campaign: $TOTAL total, $SUPPRESSED_COUNT suppressed, $((TOTAL - SUPPRESSED_COUNT)) safe to send"

clay usage show suppression-check
clay tables reset suppression-check --webhook-url https://app.clay.com/webhook/NEW_ID