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"
      },
      "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

Request body

podcastIdstringrequired

stateenumdefault "prospect"

prospectqualifiedpitchedlostbookedignored

priorityenum

lowmediumhighurgent

labelsarray of enum

automatedguest-appearancemcp

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired1 field

listedPodcastobjectrequired11 fields

listedPodcastIdstringrequired

projectIdstringrequired

podcastobjectrequired5 fields

podcastIdstringrequired

titleOriginalstringrequired

titleLateststringrequired

slugstringrequired

imageUrlstringrequirednullable

statusenumrequired

prospectqualifiedpitchedlostbookedignored

priorityenumrequirednullable

lowmediumhighurgent

labelsarray of stringrequired

addedAtdaterequired

updatedAtdaterequired

addedByUserobjectrequired3 fields

userIdstringrequired

emailstringrequired

displayNamestringrequirednullable

activityHistoryarray of objectrequired6 fields

actionTypeenumrequired

added-to-listupdate-labelsupdate-priorityupdate-state

activityDatedaterequired

fromValuestringrequirednullable

toValuestringrequirednullable

userIdstringrequired

userDisplayNamestringrequired

analysisobjectrequired3 fields

relevancyScorenumbernullable

deepRelevancyScorenumbernullable

hostRelevancyScorenumbernullable