Create Alert Config

POST https://api.podengine.ai/api/v1/alerts/alert-config

Create a new alert configuration to monitor podcasts for mentions of a person, company, or custom keyword.

Example request

curl -X POST "https://api.podengine.ai/api/v1/alerts/alert-config" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN" \
  -d '{
  "alertName": "Example Alert",
  "alertType": "person",
  "value": "Jason Calacanis"
}'

const options = {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  },
  body: JSON.stringify({
  "alertName": "Example Alert",
  "alertType": "person",
  "value": "Jason Calacanis"
})
};

fetch("https://api.podengine.ai/api/v1/alerts/alert-config", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.post("https://api.podengine.ai/api/v1/alerts/alert-config", headers=headers, json={
  "alertName": "Example Alert",
  "alertType": "person",
  "value": "Jason Calacanis"
})
print(response.json())

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

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var json = @"{
  ""alertName"": ""Example Alert"",
  ""alertType"": ""person"",
  ""value"": ""Jason Calacanis""
}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.podengine.ai/api/v1/alerts/alert-config", content);
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

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

func main() {
	jsonData := []byte(`{
  "alertName": "Example Alert",
  "alertType": "person",
  "value": "Jason Calacanis"
}`)
	body := bytes.NewBuffer(jsonData)
	req, _ := http.NewRequest("POST", "https://api.podengine.ai/api/v1/alerts/alert-config", body)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.alerts.createAlertConfig({
  alertName: 'Example Alert',
  alertType: 'person',
  value: 'Jason Calacanis',
});

console.log(data);

import os

from podengine import PodEngine

pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])

data = pe.alerts.create_alert_config(
    alert_name="Example Alert",
    alert_type="person",
    value="Jason Calacanis",
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "createdAlertConfig": {
      "id": "string",
      "createdByUserId": "string",
      "teamId": "string",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "alertName": "string",
      "alertType": "person",
      "enabled": true,
      "alertSettings": {
        "type": "person",
        "value": "string",
        "trackGuestAppearances": true,
        "trackHostAppearances": true,
        "trackMentions": true,
        "genresToSkip": [
          "string"
        ],
        "genresToInclude": [
          "string"
        ],
        "otherSpellings": [
          "string"
        ],
        "otherEmails": [
          "name@example.com"
        ],
        "contextAwareQuestion": "string",
        "contextAwareDetails": {
          "what": "string",
          "relevantClues": "string",
          "commonFalsePositives": "string"
        },
        "filterAdvertisements": true
      },
      "emailSettings": {
        "frequency": "hourly"
      },
      "lastRunDate": "2026-01-15T09:30:00.000Z"
    }
  }
}

Request

Request body

alertNamestringrequired

alertTypeenumrequired

personcompanycustom-keyword

valuestringrequired

emailSettingsobject1 field

frequencyenumrequired

hourlydailyweekly

enabledboolean

generateAlternativeSpellingsboolean

additionalAlertSettingsobject2 fields

otherEmailsarray of string

otherSpellingsarray of string

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired1 field

createdAlertConfigobjectrequired11 fields

idstringrequired

createdByUserIdstringrequired

teamIdstringrequired

createdAtdaterequired

updatedAtdaterequired

alertNamestringrequired

alertTypeenumrequired

personcompanycustom-keyword

enabledbooleanrequired

alertSettingsintersectionrequired

emailSettingsobjectrequired1 field

frequencyenumrequired

hourlydailyweekly

lastRunDatedaterequirednullable