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

# Blocked emails

> Block emails so they can no longer book a meeting or buy a package.

A blocked email cannot book a meeting or buy a package. Emails are stored lowercased and without `+tags`, and Gmail addresses without dots, so `John.Doe+promo@gmail.com` is stored as `johndoe@gmail.com`. You need the **Manage blocked emails** permission to run these commands. For fields and response details, see the [API reference](https://apidocs.neetocal.com/api/blocked-emails/list.md). Sample output on this page uses `--json`.

## List blocked emails

This command lists the workspace's blocked emails, newest first. Use this to find a blocked email's ID or to check whether an email is blocked.

```bash theme={"system"}
neetocal blocked-emails list
neetocal blocked-emails list --search john.doe@gmail.com
```

| Flag | Type | Required | Default | Description |
| - | - | - | - | - |
| `--page` | `int` | | `0` | Page number |
| `--page-size` | `int` | | `0` | Items per page (max 100) |
| `--search` | `string` | | | Search blocked emails by address |

```json Sample output (--json) theme={"system"}
{
  "data": [
    {
      "id": "3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
      "email": "johndoe@gmail.com",
      "note": "Repeated spam bookings",
      "created_at": "2026-10-27T10:15:30.000Z"
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  }
}
```

`--search` is normalized the same way as stored emails, so Gmail dots and `+tags` do not matter.

## Show a blocked email

This command shows one blocked email. Use this after finding its ID from `blocked-emails list`.

```bash theme={"system"}
neetocal blocked-emails show <id>
```

**Required arguments:**

* `<id>` - Blocked email UUID

```json Sample output (--json) theme={"system"}
{
  "data": {
    "blocked_email": {
      "id": "3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
      "email": "johndoe@gmail.com",
      "note": "Repeated spam bookings",
      "created_at": "2026-10-27T10:15:30.000Z"
    }
  }
}
```

## Block emails

This command blocks one or more emails with an optional note. Emails that are already blocked are left as they are, note included. If any email is invalid, none are blocked.

```bash theme={"system"}
neetocal blocked-emails create --emails "spammer@example.com,John.Doe+promo@gmail.com" --note "Repeated spam bookings"
```

| Flag | Type | Required | Default | Description |
| - | - | - | - | - |
| `--emails` | `string` | Yes | | Comma-separated emails to block |
| `--note` | `string` | | | Why these emails are blocked |

```json Sample output (--json) theme={"system"}
{
  "data": [
    {
      "id": "3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
      "email": "johndoe@gmail.com",
      "note": "Repeated spam bookings",
      "created_at": "2026-10-27T10:15:30.000Z"
    },
    {
      "id": "8a7b6c5d-4e3f-4a2b-9c1d-0e9f8a7b6c5d",
      "email": "spammer@example.com",
      "note": "Repeated spam bookings",
      "created_at": "2026-10-27T10:15:30.000Z"
    }
  ]
}
```

The output lists each distinct email once, sorted by address, whether newly blocked or already blocked.

## Update a blocked email

This command changes the note on a blocked email. The email itself cannot be changed. To change it, block the new email and delete this one.

```bash theme={"system"}
neetocal blocked-emails update <id> --note "Repeated no-shows"
```

**Required arguments:**

* `<id>` - Blocked email UUID

| Flag | Type | Required | Default | Description |
| - | - | - | - | - |
| `--note` | `string` | Yes | | New note; pass "" to clear it |

```json Sample output (--json) theme={"system"}
{
  "data": {
    "blocked_email": {
      "id": "3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
      "email": "johndoe@gmail.com",
      "note": "Repeated no-shows",
      "created_at": "2026-10-27T10:15:30.000Z"
    }
  }
}
```

## Delete a blocked email

This command unblocks an email so it can book meetings and buy packages again.

```bash theme={"system"}
neetocal blocked-emails delete <id>
```

**Required arguments:**

* `<id>` - Blocked email UUID

```text Sample output theme={"system"}
Email unblocked.
```

In `--quiet` mode, this prints `success`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.