Solo Work — Own your professional intelligence

Webhook Events

When using custom workflow tools (such as n8n), Solo sends events to your webhook endpoint. This document describes the event structure and types.

Event Structure

All events follow this structure:

{
  "eventId": "uuid",
  "scope": "identity" | "business",
  "identityId": "uuid",
  "agent": {
    "id": "uuid",
    "kind": "inbox-manager",
    "name": "Jordan"
  },
  "type": "email" | "chat" | "task" | "agent" | "system",
  "visibility": "visible" | "silent" | "internal",
  "conversationId": "uuid",
  "content": "...",
  "metadata": { ... },
  "createdAt": "2025-01-15T10:30:00Z"
}

Event Fields

eventId

scope

identityId

agent

type

visibility

conversationId

content

metadata

createdAt

Event Types

Email Events

Type: "email"

Metadata:

{
  "emailData": {
    "subject": "Meeting Request",
    "body": "...",
    "from": "sender@example.com",
    "to": ["recipient@solomail.io"],
    "headers": { ... }
  },
  "routing": {
    "source": "email",
    "roleId": "inbox-manager"
  }
}

Common Events:

Task Events

Type: "task"

Metadata:

{
  "taskData": {
    "title": "Follow up with customer",
    "status": "pending",
    "intent": "INQUIRY"
  },
  "routing": {
    "source": "email",
    "roleId": "inbox-manager"
  }
}

Common Events:

Chat Events

Type: "chat"

Metadata:

{
  "chatData": {
    "channel": "slack",
    "message": "...",
    "thread": "uuid"
  }
}

Common Events:

Agent Events

Type: "agent"

Metadata:

{
  "agentData": {
    "action": "email.reply",
    "decision": "send",
    "confidence": 0.85
  }
}

Common Events:

System Events

Type: "system"

Metadata:

{
  "systemData": {
    "event": "identity.activated",
    "data": { ... }
  }
}

Common Events:

Processing Events

In Your Workflow Tool (e.g., n8n)

  1. Receive webhook: Your workflow tool receives event
  2. Parse event: Extract event data
  3. Route by type: Handle different event types
  4. Process: Take appropriate action
  5. Respond: Return result (if needed)

Example Workflow

Webhook Trigger
  ↓
Switch (by event.type)
  ├─ email → Email Handler
  ├─ task → Task Handler
  ├─ chat → Chat Handler
  └─ agent → Agent Handler

Best Practices

Handle All Event Types

Validate Events

Idempotency

Error Handling

Security

Authentication

Rate Limiting

Troubleshooting

Not receiving events?

Events not processing?

Duplicate events?

Next Steps

Version: 1.0

Last Updated: November 2025