CRM Integrations & Webhooks

Sync your community events with your CRM, Slack, or any webhook-enabled tool.

Why Integrate?

Community data is useless if it stays siloed. With webhooks, you can:

• Push new members to HubSpot - Create leads automatically
• Alert Slack on crises - Get notified when sentiment drops
• Sync to Salesforce - Update customer records in real-time
• Trigger Zapier automations - Connect to 5000+ apps

Setting Up Webhooks

Go to Dashboard → Settings → Integrations.

1. Create an Endpoint

Click Add Webhook and configure:

• Name: "HubSpot Lead Sync"
• URL: Your webhook endpoint (from HubSpot, Zapier, etc.)
• Events: Select which events to send

2. Available Events

Event	Trigger
member.created	New member joins
member.leveled	Member gains XP level
member.churning	Churn risk detected
message.flagged	Moderation trigger
support.detected	Support request found
sentiment.crisis	Sentiment below threshold
campaign.sent	Email campaign sent

3. Security (HMAC)

Each webhook includes an X-Sovereign-Signature header for verification:

const crypto = require('crypto');
const signature = crypto
    .createHmac('sha256', YOUR_SECRET)
    .update(requestBody)
    .digest('hex');

// Compare with X-Sovereign-Signature header

Integration Examples

Zapier

1. Create a Zap with "Webhooks by Zapier" trigger
2. Select "Catch Hook"
3. Copy the webhook URL to Sovereign
4. Map fields to your desired action

HubSpot

1. Go to HubSpot → Workflows → Create workflow
2. Set enrollment trigger to "Webhook received"
3. Copy the webhook URL to Sovereign

Monitoring

Track webhook health in the Integrations panel:

• ✅ Success count
• ❌ Failure count
• 🕐 Last triggered timestamp