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

# Real-time updates

> How to react to changes in a workspace as they happen.

To react to workspace changes from your own system, use **[webhooks](/dev/webhooks/overview)**. Custral posts a signed event to your endpoint when a record changes, a form is submitted, a task is
completed, or a conversation is given an outcome, and the [SDK](/dev/sdks/typescript) verifies the
signature for you. The [event catalog](/dev/webhooks/events/overview) is the complete list.

```ts theme={null}
import {Custral} from "@custral/sdk";

const custral = new Custral({apiKey: process.env.CUSTRAL_API_KEY!});

custral.on("record.updated", (event) => {
  // …your logic, running on your infra
});
```

<Note>
  Custral's own web, desktop, and mobile clients hold live socket connections for
  in-app presence and collaborative editing. Those transports are **internal**.
  They aren't part of the public API, they authenticate as a signed-in user
  rather than with an API key, and their shape changes without notice. Webhooks
  are the supported way to receive changes programmatically.
</Note>

## Choosing between webhooks and polling

| You want                          | Use                                                               |
| --------------------------------- | ----------------------------------------------------------------- |
| To be told when something changes | [Webhooks](/dev/webhooks/overview)                                |
| A snapshot right now              | [`GET /v1/records/{object}`](/dev/api-reference/records)          |
| To catch up after downtime        | List with a `sort` on the updated timestamp, then resume webhooks |

## See also

<CardGroup cols={2}>
  <Card title="Webhooks" icon="webhook" href="/dev/webhooks/overview">
    Subscribe to events, verify signatures, and handle retries.
  </Card>

  <Card title="Requests & responses" icon="right-left" href="/dev/api-reference/requests">
    The envelope every endpoint returns, and how to page through a list.
  </Card>
</CardGroup>


## Related topics

- [Inbox](/comms/inbox/overview.md)
- [React SDK](/dev/sdks/react.md)
- [Change Log](/product/updates.md)
- [Widgets](/blocks/widgets/overview.md)
- [Update status & outcome](/api-reference/conversations/update-status-&-outcome.md)