Add Podcast to Project

POST https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts

Add a single podcast to a project's list

Example request

curl -X POST "https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN"

const options = {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  }
};

fetch("https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts", 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/projects/:projectSlug/podcasts", headers=headers)
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 response = await client.PostAsync("https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts");
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

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

func main() {
	req, _ := http.NewRequest("POST", "https://api.podengine.ai/api/v1/projects/:projectSlug/podcasts", nil)
	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.projects.addPodcastToProject({
  projectSlug: 'example-project',
  podcastId: '<podcastId>',
  state: 'prospect',
});

console.log(data);

import os

from podengine import PodEngine

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

data = pe.projects.add_podcast_to_project(
    project_slug="example-project",
    podcast_id="<podcastId>",
    state="prospect",
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "listedPodcast": {
      "listedPodcastId": "string",
      "projectId": "string",
      "podcast": {
        "podcastId": "string",
        "titleOriginal": "string",
        "titleLatest": "string",
        "slug": "string",
        "imageUrl": "string",
        "estimatedMonthlyListeners": 0,
        "estimatedMonthlyListenersBucket": "0-1K"
      },
      "status": "prospect",
      "priority": "low",
      "labels": [
        "string"
      ],
      "addedAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "addedByUser": {
        "userId": "string",
        "email": "string",
        "displayName": "string"
      },
      "activityHistory": [
        {
          "actionType": "added-to-list",
          "activityDate": "2026-01-15T09:30:00.000Z",
          "fromValue": "string",
          "toValue": "string",
          "userId": "string",
          "userDisplayName": "string"
        }
      ],
      "analysis": {
        "relevancyScore": 0,
        "deepRelevancyScore": 0,
        "hostRelevancyScore": 0
      }
    }
  }
}

Request

Path parameters

projectSlugstringrequired

URL slug identifying the project.

Request body

podcastIdstringrequired

Pod Engine ID of the podcast to add to this project.

stateenumdefault "prospect"

Initial workflow state for the podcast in this project.

prospectqualifiedpitchedlostbookedignored

priorityenum

Priority of this podcast within the project.

lowmediumhighurgent

labelsarray of enum

Labels to apply to the podcast entry in this project.

automatedguest-appearancemcp

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired1 field

listedPodcastobjectrequired11 fields

listedPodcastIdstringrequired

projectIdstringrequired

podcastobjectrequired7 fields

podcastIdstringrequired

titleOriginalstringrequired

titleLateststringrequired

slugstringrequired

imageUrlstringrequirednullable

estimatedMonthlyListenersnumberrequirednullablemin 0

estimatedMonthlyListenersBucketenumrequirednullable

Bucket for the estimated monthly listeners: 0-1K, 1K-10K, 10K-100K, 100K-1M or 1M+. 0-1K means the estimate is under 1,000, even when the rounded figure reads 1,000. Null means no estimate is available.

0-1K1K-10K10K-100K100K-1M1M+

statusenumrequired

prospectqualifiedpitchedlostbookedignored

priorityenumrequirednullable

lowmediumhighurgent

labelsarray of stringrequired

addedAtdaterequired

updatedAtdaterequired

addedByUserobjectrequired3 fields

userIdstringrequired

emailstringrequired

displayNamestringrequirednullable