> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> Real-time notifications from your connectors and from StackOne.

An **event** is something that happened — a Slack message arrived, a file was added, an account was connected — delivered to your **webhook** (an HTTPS endpoint) in real time, so your app reacts without polling.

```mermaid theme={null}
sequenceDiagram
    participant App as App / Agent
    participant S as StackOne
    participant P as Provider

    rect rgb(219, 234, 254)
        Note over App,P: Events — the provider tells you
        P->>S: Provider webhook
        Note over S: Connector Profile —<br/>enabled events + webhook routing
        S->>App: Normalized event to your webhook
    end
```

## Kinds of events

* **Connector events** — fire from a provider (a new Notion page, a file dropped in SharePoint). Enabled per connector on its [connector profile](/gateway/concepts/connector-profiles).
* **[Platform events](/platform-api/platform-events)** — fire from StackOne itself, covering account lifecycle: `account.created`, `account.updated`, `account.deleted`.

<Card title="Webhooks & events" icon="webhook" href="/connect/webhooks">
  Set up a webhook, subscribe to events, and verify delivery.
</Card>