Notifications

Create notification

Create a new notification bound to an existing notification method.

Supported types

  • email requires value (email). second_type is not allowed.
  • domain requires value (domain). second_type optional: one of domain leak types, default ALL.
  • advanced requires filters (no value). Bulk is not allowed.

Bulk creation

  • For email and domain, set bulk=true and provide newline-separated values in value to create several notifications at once.

Limit

  • Max notifications = plan limit + extra monitoring assets purchased.
post/notifications

Request body

method_idinteger nullable

Notification method ID to use.

type'email' | 'domain' | 'advanced' | 'raw' | 'dark_web' required
valuestring nullable

Value to monitor (required for EMAIL/DOMAIN types).

filtersobject nullable

Filters when type=ADVANCED or RAW. Parsed according to type.

auto_unlockboolean nullable

If true, automatically unlock new matching leaks (consumes points).

max_pointsinteger nullable

Daily points cap for auto-unlock (if enabled).

second_type'ALL' | 'EMPLOYEES' | 'THIRD_PARTIES' | 'CUSTOMERS'
bulkboolean nullable

Create multiple notifications at once (e.g., newline-separated values).

Example request

{
  "method_id": 1,
  "type": "domain",
  "value": "example.com"
}

Response

Notification created successfully.

OR

Changes

No recorded changes to this endpoint across all 1 revision of this API.