Notification Rule Create

POSThttps://api.deepinfo.com/v1/platform/notification-rules

Creates a notification rule: the event scope (e.g. new_issue_detected), an optional strategy (conditions such as asset, severity, tags), frequency (instant, hourly, daily, weekly, monthly), delivery_hour / delivery_day_of_week and the team members (user ids) to email.

Example

Request

curl

curl -X POST 'https://api.deepinfo.com/v1/platform/notification-rules' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Critical issues",
  "scope": "new_asset_added",
  "frequency": "daily",
  "delivery_hour": 8,
  "members": [
    "00000000-0000-4000-8000-00006bb60001"
  ],
  "enabled": true
}'

Python

import requests

url = "https://api.deepinfo.com/v1/platform/notification-rules"

headers = {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

payload = {
    "name": "Critical issues",
    "scope": "new_asset_added",
    "frequency": "daily",
    "delivery_hour": 8,
    "members": [
        "00000000-0000-4000-8000-00006bb60001"
    ],
    "enabled": True
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
print(response.json())

JavaScript

const url = "https://api.deepinfo.com/v1/platform/notification-rules";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "Critical issues",
    scope: "new_asset_added",
    frequency: "daily",
    delivery_hour: 8,
    members: [
      "00000000-0000-4000-8000-00006bb60001"
    ],
    enabled: true
  }),
});

const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	payload := strings.NewReader(`{
  "name": "Critical issues",
  "scope": "new_asset_added",
  "frequency": "daily",
  "delivery_hour": 8,
  "members": [
    "00000000-0000-4000-8000-00006bb60001"
  ],
  "enabled": true
}`)

	req, err := http.NewRequest("POST", "https://api.deepinfo.com/v1/platform/notification-rules", payload)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", "YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String body = """
            {
              "name": "Critical issues",
              "scope": "new_asset_added",
              "frequency": "daily",
              "delivery_hour": 8,
              "members": [
                "00000000-0000-4000-8000-00006bb60001"
              ],
              "enabled": true
            }""";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.deepinfo.com/v1/platform/notification-rules"))
            .header("apikey", "YOUR_API_KEY")
            .header("Accept", "application/json")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;
using System.Text;

using var client = new HttpClient();

var body = """
    {
      "name": "Critical issues",
      "scope": "new_asset_added",
      "frequency": "daily",
      "delivery_hour": 8,
      "members": [
        "00000000-0000-4000-8000-00006bb60001"
      ],
      "enabled": true
    }
    """;

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.deepinfo.com/v1/platform/notification-rules");
request.Headers.Add("apikey", "YOUR_API_KEY");
request.Headers.Add("Accept", "application/json");
request.Content = new StringContent(body, Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php

$body = <<<'JSON'
{
  "name": "Critical issues",
  "scope": "new_asset_added",
  "frequency": "daily",
  "delivery_hour": 8,
  "members": [
    "00000000-0000-4000-8000-00006bb60001"
  ],
  "enabled": true
}
JSON;

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.deepinfo.com/v1/platform/notification-rules',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $body,
]);

$response = curl_exec($curl);

if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}

echo $response . PHP_EOL;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://api.deepinfo.com/v1/platform/notification-rules')

request = Net::HTTP::Post.new(uri)
request['apikey'] = 'YOUR_API_KEY'
request['Accept'] = 'application/json'
request['Content-Type'] = 'application/json'
request.body = <<~'JSON'.chomp
  {
    "name": "Critical issues",
    "scope": "new_asset_added",
    "frequency": "daily",
    "delivery_hour": 8,
    "members": [
      "00000000-0000-4000-8000-00006bb60001"
    ],
    "enabled": true
  }
JSON

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Response

201 Created · application/json

Response Body

{
  "id": "000000000000000e8e040001",
  "name": "Critical issues",
  "scope": "new_asset_added",
  "frequency": "daily",
  "delivery_hour": 8,
  "delivery_day_of_week": null,
  "members": [
    {
      "team_member_uuid": "00000000-0000-4000-8000-0000f3aa0001",
      "email": "user@acme.example"
    }
  ],
  "enabled": true,
  "added_date": "2025-06-01T08:00:00Z",
  "last_update_date": "2025-07-01T08:00:00Z",
  "strategy": null
}

Content-Type: application/json
deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001

Request

curl

curl -X POST 'https://api.deepinfo.com/v1/platform/notification-rules' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{}'

Python

import requests

url = "https://api.deepinfo.com/v1/platform/notification-rules"

headers = {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

payload = {}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
print(response.json())

JavaScript

const url = "https://api.deepinfo.com/v1/platform/notification-rules";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({}),
});

const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	payload := strings.NewReader(`{}`)

	req, err := http.NewRequest("POST", "https://api.deepinfo.com/v1/platform/notification-rules", payload)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", "YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.deepinfo.com/v1/platform/notification-rules"))
            .header("apikey", "YOUR_API_KEY")
            .header("Accept", "application/json")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{}"))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;
using System.Text;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.deepinfo.com/v1/platform/notification-rules");
request.Headers.Add("apikey", "YOUR_API_KEY");
request.Headers.Add("Accept", "application/json");
request.Content = new StringContent("{}", Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.deepinfo.com/v1/platform/notification-rules',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY',
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => '{}',
]);

$response = curl_exec($curl);

if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}

echo $response . PHP_EOL;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://api.deepinfo.com/v1/platform/notification-rules')

request = Net::HTTP::Post.new(uri)
request['apikey'] = 'YOUR_API_KEY'
request['Accept'] = 'application/json'
request['Content-Type'] = 'application/json'
request.body = '{}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Response

400 Bad Request · application/json

Response Body

{
  "code": 10400,
  "parameters": [
    {
      "param": "name",
      "details": [
        "This field is required."
      ]
    },
    {
      "param": "scope",
      "details": [
        "This field is required."
      ]
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}

Content-Type: application/json
deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001

Authentication

Send your API key in the apikey request header.

Request Body

Parameter	Type	Required	Description
`name`	string	Required	min length `1`; max length `255`
`scope`	string	Required	One of `new_issue_detected`, `reappeared_issue_detected`, `asset_security_score_decreased`, `asset_security_score_changed`, `asset_ssl_changed`, `asset_whois_changed`, `asset_dns_changed`, `domain_security_score_decreased`, `domain_security_score_changed`, `new_asset_discovered`, `new_asset_added`, `new_vulnerability_detected`, `reappeared_vulnerability_detected`, `new_email_breach_detected`, `new_suspicious_domain_detected`, `new_fraudulent_domain_detected`, `new_open_port_detected`, `new_employee_credential_detected`, `new_client_credential_detected`, `new_payment_credential_detected`, `new_cybersecurity_news_added`
`strategy`	object	Optional
`frequency`	string	Optional	One of `instant`, `hourly`, `daily`, `weekly`, `monthly`
`delivery_hour`	integer	Optional	min `0.0`; max `23.0`
`delivery_day_of_week`	integer	Optional	min `0.0`; max `6.0`
`members`	array	Required	min items `1`
`enabled`	boolean	Optional

application/json

{
  "name": "Critical issues",
  "scope": "new_asset_added",
  "frequency": "daily",
  "delivery_hour": 8,
  "members": [
    "00000000-0000-4000-8000-00006bb60001"
  ],
  "enabled": true
}

Response Fields

Field	Type	Description
`id`	string
`name`	string
`scope`	string	One of `new_issue_detected`, `reappeared_issue_detected`, `asset_security_score_decreased`, `asset_security_score_changed`, `asset_ssl_changed`, `asset_whois_changed`, `asset_dns_changed`, `domain_security_score_decreased`, `domain_security_score_changed`, `new_asset_discovered`, `new_asset_added`, `new_vulnerability_detected`, `reappeared_vulnerability_detected`, `new_email_breach_detected`, `new_suspicious_domain_detected`, `new_fraudulent_domain_detected`, `new_open_port_detected`, `new_employee_credential_detected`, `new_client_credential_detected`, `new_payment_credential_detected`, `new_cybersecurity_news_added`
`frequency`	string	One of `instant`, `hourly`, `daily`, `weekly`, `monthly`
`delivery_hour`	integer
`delivery_day_of_week`	integer
`members`	array of object
`enabled`	boolean
`added_date`	string	date-time
`last_update_date`	string	date-time
`strategy`	object

Response Schema

Inferred from examples Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

Field	Type	Example
`id`	string	`"000000000000000e8e040001"`
`name`	string	`"Critical issues"`
`scope`	string	`"new_asset_added"`
`frequency`	string	`"daily"`
`delivery_hour`	number	`8`
`delivery_day_of_week`	null
`members`	array<object>
`members[].team_member_uuid`	string	`"00000000-0000-4000-8000-0000f3aa0001"`
`members[].email`	string
`enabled`	boolean	`true`
`added_date`	string	`"2025-06-01T08:00:00Z"`
`last_update_date`	string	`"2025-07-01T08:00:00Z"`
`strategy`	null

Examples

Selecting one loads it into the request and response panels.

Reference updated September 27, 2026