Create a notification trigger

Pro+ tier

POSThttps://lens-api.tic.io/watchlists/{id}/notifications

Authorization

x-api-keystringheaderrequired

Your API key, sent in the x-api-key header.

Path parameters

idstringrequired

Watchlist GUID

format: uuid

Bodyapplication/json

destinationstring | null

destinationTypestring

One of: webhook email sms

Responses

Notification trigger created · application/json

notificationIdstring

format: uuid

destinationstring | null

destinationTypestring

One of: webhook email sms

destinationTypeDescriptionstring | nullread-only

hasBeenValidatedboolean

lastUpdatedAtUtcstring

format: date-time

Authorization

Stored in this browser only (until you forget it) and sent as the x-api-key header through the documentation proxy.

Path

id *string

Body application/json

Enter your API key to send.

Request

curl -X POST "https://lens-api.tic.io/watchlists/{id}/notifications" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "destination": "<string>",
  "destinationType": "webhook"
}'

{
  "notificationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "destination": "<string>",
  "destinationType": "webhook",
  "destinationTypeDescription": "<string>",
  "hasBeenValidated": true,
  "lastUpdatedAtUtc": "2026-01-15T10:30:00Z"
}