Blocked emails

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. 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.

neetocal blocked-emails list
neetocal blocked-emails list --search john.doe@gmail.com

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

Sample output (--json)

{
  "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.

neetocal blocked-emails show <id>

Required arguments:

<id> - Blocked email UUID

Sample output (--json)

{
  "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.

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

Sample output (--json)

{
  "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.

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

Sample output (--json)

{
  "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.

neetocal blocked-emails delete <id>

Required arguments:

<id> - Blocked email UUID

Sample output

Email unblocked.

In --quiet mode, this prints success.

Getting started

Commands

List blocked emails

Show a blocked email

Block emails

Update a blocked email

Delete a blocked email

​List blocked emails

​Show a blocked email

​Block emails

​Update a blocked email

​Delete a blocked email

List blocked emails

Show a blocked email

Block emails

Update a blocked email

Delete a blocked email