EventCatalog | Events | Workspace Created

Overview

The WorkspaceCreated event signals that a new workspace has been initialized. This event triggers downstream processes like setting up default projects, creating admin access, and initializing analytics.

When is this event emitted?

This event is published after:

Workspace data is validated
Workspace is created in the database
Default settings are initialized
Creator is assigned as workspace admin

Event Schema

Schema Definition

{
  "eventId": "uuid",
  "eventType": "WorkspaceCreated",
  "timestamp": "2025-12-11T10:30:00Z",
  "version": "1.0.0",
  "data": {
    "workspaceId": "string",
    "name": "string",
    "subdomain": "string",
    "createdBy": {
      "userId": "string",
      "email": "string",
      "name": "string"
    },
    "plan": "free | pro | enterprise",
    "settings": {
      "timezone": "string",
      "dateFormat": "string",
      "weekStartsOn": "number"
    },
    "createdAt": "timestamp"
  }
}

Example Payload

{
  "eventId": "evt_a1b2c3d4-e5f6-7890",
  "eventType": "WorkspaceCreated",
  "timestamp": "2025-12-11T10:30:00Z",
  "version": "1.0.0",
  "data": {
    "workspaceId": "ws_acme_corp",
    "name": "Acme Corporation",
    "subdomain": "acme",
    "createdBy": {
      "userId": "usr_john_doe",
      "email": "john@acme.com",
      "name": "John Doe"
    },
    "plan": "pro",
    "settings": {
      "timezone": "America/New_York",
      "dateFormat": "MM/DD/YYYY",
      "weekStartsOn": 1
    },
    "createdAt": "2025-12-11T10:30:00Z"
  }
}

Downstream Actions

When this event is consumed:

Billing Service: Initializes billing account and subscription
Analytics Service: Creates workspace analytics dashboard
Notification Service: Sends welcome email to workspace creator
Search Service: Indexes workspace for search
Audit Service: Creates audit log entry

Business Rules

Event must be published within 2 seconds of workspace creation
Subdomain must be unique across the platform
Creator automatically becomes workspace admin
Default team “Everyone” is automatically created

Workspace Created

Emitted when a new workspace is successfully created in the system