Create Alert

Creates an alert for a specific entity (URL or phone number) within Doppel's Brand Protection product.

Behavior:

  • If an alert already exists for the entity, the existing alert is returned (HTTP 200).
  • If the alert exists but with a different brand than requested, returns HTTP 409.
  • After creation, the alert is automatically processed through Doppel's triage workflow.
  • If source is provided, it must exactly match the "API value" field of an external source configured in your organization's settings in Doppel Vision.

Returns HTTP 400 when:

  • entity is missing, not a valid URL, or not a valid phone number.
  • entity is a protected asset (e.g. google.com).
  • tags is not a list of non-empty strings.
  • source does not match any configured external source for the organization.
  • files contains more than 10 items, duplicate file names, or is missing file_to_upload.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Headers
string

(optional) Your Doppel Organization Code. Required if user is in multiple organizations.

Body Params
string
required

URL or phone number to be alerted.

string

The brand name to associate with the alert. Must match an active (non-archived) brand in your organization. Case-insensitive.

tags
array of strings

Array of tag names to associate with the alert. Tags must already exist for your organization or be global tags.
Tags that don't exist will be silently ignored.

tags
string

Custom API source identifier configured in organization settings in Doppel Vision. Must exactly match the "API value" field of the desired source.

files
array of objects
length ≤ 10

Optional list of files to upload with the alert. Each file must include base64-encoded content. Maximum 10 files per request.
For Telco alerts, uploaded image files may also be used as the alert's canonical screenshot. If an uploaded Telco image is selected as the screenshot, Doppel stores a separate screenshot copy for alert review and downstream enforcement workflows while preserving the original Uploaded Files copy. Only upload image files that are appropriate to display as alert evidence.

files
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json