hubspot-incident-runbook

# HubSpot Incident Runbook ## Overview Rapid incident response procedures for HubSpot CRM integration failures, including triage, mitigation, and postmortem templates. ## Prerequisites - Access to application logs and metrics - `HUBSPOT_ACCESS_TOKEN` available for manual testing - Communication channels (Slack, PagerDuty) ## Instructions ### Step 1: Quick Triage (< 2 minutes) ```bash #!/bin/bash # hubspot-triage.sh -- Run this first during any incident echo "=== HubSpot Quick Triage ===" echo "Time: $(date -u)" # 1. Is HubSpot itself down? echo "" echo "--- HubSpot Platform Status ---" curl -s https://status.hubspot.com/api/v2/summary.json | jq '{ status: .status.description, active_incidents: [.incidents[] | {name, status, updated_at}] }' # 2. Can we reach the API? echo "" echo "--- API Connectivity ---" STATUS=$(curl -so /dev/null -w "%{http_code}" \ https://api.hubapi.com/crm/v3/objects/contacts?limit=1 \ -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN") echo "API Status: HTTP $STATUS" # 3. Rate limit state echo "" echo "--- Rate Limits ---" curl -sI https://api.hubapi.com/crm/v3/objects/contacts?limit=1 \ -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \ | grep -i "ratelimit\|retry-after" # 4. Check our health endpoint echo "" echo "--- Our Health Check ---" curl -sf https://your-app.com/health | jq '.services.hubspot' || echo "Health check failed" ``` ### Step 2: Decision Tree ``` Is HubSpot status page showing an incident? ├── YES → HubSpot-si...