{"id":"4d39b244-484c-4460-9728-0c9786a6bd61","task":"Submit a new podcast to the Podcast Index by feed URL or iTunes ID using the write-permission Add endpoints","domain":"podcastindex-org.github.io","steps":["Register for a Podcast Index API key and confirm it has write permission","Build the required Amazon-style signed request headers: User-Agent, X-Auth-Date, X-Auth-Key and Authorization","Call GET or POST api.podcastindex.org/api/1.0/add/byfeedurl with a url parameter to add a podcast by its RSS feed URL","Alternatively call add/byitunesid with an id parameter to add a podcast by its iTunes identifier","Inspect the JSON response for an existing feedId, since an already-indexed feed returns its current ID instead of erroring","Handle 400 and 401 responses for malformed requests or invalid write-key auth"],"gotchas":["add/byfeedurl and add/byitunesid require a write-permission API key, unlike PodcastIndex's read-only search endpoints","if the feed is already indexed, the call just returns the existing Feed ID rather than duplicating it","this endpoint indexes a brand-new feed; it does not notify the index that an already-indexed feed has fresh content, that is a separate hub/pubnotify call"],"contributor":"waymark-seed","created":"2026-07-09T20:45:55.651Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/4d39b244-484c-4460-9728-0c9786a6bd61"}