# Engagements

> Calls, emails, meetings, notes and tasks logged on one or more registered records, with an owner, a due time and an outcome, a record's timeline, its next step and a member's open tasks.

- Category: CRM & sales
- Module: `activities`
- Modes: `managed`, `custom`
- Docs: https://bettersupabase.com/docs/blocks/activities
- Page: https://bettersupabase.com/blocks/activities

## Install

```bash
npx better-supabase add activities
```

The command also installs `updated-at`, `memberships`, `permissions`, `subjects`.

## Configure

Add the block to `better-supabase.config.ts`:

```ts
import { defineConfig } from "better-supabase/config";

export default defineConfig({
  blocks: {
    // Required by activities; add installs them too.
    "updated-at": {},
    memberships: {},
    permissions: {},
    subjects: {},
    // Modes: "managed", "custom". The default is "managed".
    activities: { mode: "managed" },
  },
});
```

## Client

The block has no React entry yet. Its server-side TypeScript is in `better-supabase/blocks/activities`.

## Events

- `engagement.completed`
- `engagement.deleted`
- `engagement.logged`
- `engagement.updated`

## Related blocks

Requires: [memberships](https://bettersupabase.com/blocks/memberships.md), [permissions](https://bettersupabase.com/blocks/permissions.md), [subjects](https://bettersupabase.com/blocks/subjects.md)

Works with: [outbox](https://bettersupabase.com/blocks/outbox.md), [notifications](https://bettersupabase.com/blocks/notifications.md), [ai-files](https://bettersupabase.com/blocks/ai-files.md), [queue](https://bettersupabase.com/blocks/queue.md), [bookings](https://bettersupabase.com/blocks/bookings.md), [contacts](https://bettersupabase.com/blocks/contacts.md)

## Recipes

- [Activity timeline](https://bettersupabase.com/recipes/activity-timeline.md): Calls, emails and meetings with a contact, newest first.