Event Catalog

Below are the event types you can subscribe to via Workspace Webhooks.

Common Payload Structure

All webhook requests send a JSON body with this envelope:

json

{
  "id": "evt_1234567890",        // Unique event ID
  "owner_id": "user_123",        // Your workspace owner ID
  "type": "signup.created",      // The event type
  "created_at": "2023-01-01T12:00:00Z",
  "data": { ... }                // The actual event data
}

signup.created

Fired when a user submits the signup form. If double opt-in is on, status will be pending.

data object

{
  "signup_id": "signup_abc123",
  "email": "user@example.com",
  "status": "pending",
  "project_id": "proj_xyz789",
  "project_name": "My Beta Launch",
  "referral_code": "REF123"
}

signup.confirmed

Fired when a user verifies their email or if double opt-in is disabled. This is the best event to use for syncing to your production database or CRM.

data object

{
  "signup_id": "signup_abc123",
  "email": "user@example.com",
  "referral_code": "REF123",
  "queue_position": 42,
  "project_id": "proj_xyz789",
  "project_name": "My Beta Launch"
}

signup.referred

Fired when a confirmed signup is attributed to another user. Useful for notifying users ("You just got a referral!").

data object

{
  "signup_id": "signup_abc123",      // The new user
  "inviter_signup_id": "signup_inv456", // The referrer
  "referral_code": "REF_INVITER",
  "project_id": "proj_xyz789"
}