Webhooks & Event Architecture

To build dynamic, responsive systems on top of Social Flow, developers can subscribe to real-time events through our webhook infrastructure. This allows external services, bots, and tools to react immediately when key actions happen inside the Social Flow agent ecosystem.

Whether you want to notify a team on Slack, push updates to Notion, log performance metrics in Airtable, or trigger on-chain recordings — this is the bridge.

---

Supported Events

You can subscribe to any of the following:

• post_published – Fired when a post successfully goes live

• forecast_ready – Triggered when a QPF scheduling result is available

• agent_trained – Fired when agent memory is updated or reset

• analytics_updated – Fired after new engagement stats are processed

• plugin_triggered – Logs execution of a custom skill/plugin

---

Sample Webhook Payload

{
  "event": "post_published",
  "timestamp": "2025-05-29T16:47:00Z",
  "agent_id": "sf_042",
  "platform": "X",
  "post_id": "xpost-8823",
  "content_preview": "5 tools I wish I knew earlier…"
}

---

Setting Up a Webhook

1. Go to Developer > Webhooks in your dashboard

2. Register your endpoint URL

3. Select the events to subscribe to

4. Test delivery using the simulator

You can also manage webhooks via the API:

POST /v1/webhooks
{
  "url": "https://yourapp.com/hook",
  "events": ["post_published", "analytics_updated"]
}

---

Retry & Delivery

• Webhooks use exponential backoff on failure (max 3 attempts)

• All events include signature headers for verification

• Webhook logs are available in the dashboard for 7 days

---

Developer Use Cases

• Discord Alerts: Notify community when a new post drops

• CRM Syncing: Pull analytics to update lead/contact profiles

• On-chain Logs: Connect to smart contracts or store in decentralized storage

• Automated Reports: Pipe weekly post summaries into Google Sheets or Notion

---

Social Flow’s event system helps you do more than just monitor — it gives you the tools to extend and automate, no matter where your workflow lives.