Setting Up a Webhook Filter

Use-cases for Webhook Filters

• Do you want to monitor your brand? Set up a filter to get notified whenever your brand or website are mentioned.

• Are you doing sales intelligence or lead nurturing? Set up a filter to get notified when a potential lead appears on an episode, get the transcript of the episode and use this data for insights or lead scoring.

• Are you doing competitor or industry research? Set up a filter to get notified when an industry keyword or competitor’s key executive is mentioned, get the transcript of the episode and use this data for insights.

Add a Webhook Filter

1. Selecting a filter type (e.g., podcastepisode.created).

2. Adding a regex expression

// EXAMPLE WEBHOOK event for a PodcastEpisode
{
  "uuid": "5c04591a-ac2e-49a2-acf8-417776ab7bf0",
  "taddyType": "podcastepisode",
  "action": "created",
  "timestamp": 1762077600,
  "data": {
    "uuid": "5c04591a-ac2e-49a2-acf8-417776ab7bf0",
    "hash": "e9741462006248fc1ce94ac501240873e75a644414f41e638ca606664e706218",
    "name": "Version History: Zune",
    "description": "<p>In 2006, Microsoft came for the iPod's throne with an innovative MP3 player called the Zune. It had a bunch of features the iPod didn't: WiFi, music sharing, a bigger screen, a beautiful UI, even an FM radio. And to hear Microsoft describe it, it was even kind of a social network. Nilay Patel and Victoria Song join David Pierce to break down why, despite all that, the Zune never really took off. And why it came in brown.</p>\n<p><strong>If you like the show, ⁠</strong><a href=\"https://link.chtbl.com/versionhistory\">⁠subscribe to the Version History feed⁠</a><strong>⁠ to make sure you get every new episode.</strong></p>\n<p><strong></strong><a href=\"https://www.theverge.com/subscribe\">⁠Subscribe to The Verge⁠</a> for unlimited access to <a href=\"http://theverge.com/\">⁠</a><a href=\"http://theverge.com/\">theverge.com</a><a href=\"http://theverge.com/\">⁠</a>, subscriber-exclusive newsletters, and our <a href=\"https://www.theverge.com/bulletin/795051/verge-podcast-ad-free-set-up-how-to\">⁠ad-free podcast feed⁠</a>.</p>\n<p>We love hearing from you! Email your questions and thoughts to <a href=\"mailto:[email protected]\">⁠[email protected]⁠</a> or call us at 866-VERGE11.</p><p> </p><p>Learn more about your ad choices. Visit <a href=\"https://podcastchoices.com/adchoices\">podcastchoices.com/adchoices</a></p>",
    "imageUrl": null,
    "datePublished": 1762077600,
    "guid": "b1b3b8a4-97ea-11f0-8c9e-a31de8fbd080",
    "subtitle": null,
    "audioUrl": "https://www.podtrac.com/pts/redirect.mp3/pdst.fm/e/pscrb.fm/rss/p/traffic.megaphone.fm/VMP7431183096.mp3?updated=1762092793",
    "videoUrl": null,
    "fileLength": null,
    "fileType": "audio/mpeg",
    "duration": 4638,
    "episodeType": "FULL",
    "seasonNumber": null,
    "episodeNumber": null,
    "websiteUrl": null,
    "isExplicitContent": false,
    "isRemoved": null,
    "podcastSeries": {
      "uuid": "4bb5a32e-3c92-4669-b8f1-6360ada2cc94",
      "name": "The Vergecast",
      "rssUrl": "https://feeds.megaphone.fm/vergecast",
      "itunesId": 430333725,
      "language": "ENGLISH",
      "genres": ["PODCASTSERIES_TECHNOLOGY", "PODCASTSERIES_NEWS", "PODCASTSERIES_NEWS_TECH"],
      "popularityRank": "TOP_2000"
    }
  },
  matchingFilters: ['12345678-abcdefgh-12345678-abcdefgh']
}

• You can set up multiple filters, when there is a new podcast or episode data, we check to see if it successfully matches regex expressions from ANY of your filters.

• By default, Business accounts come with 100 webhook filters, contact [email protected] if you’d like to add more to your account.

• If more than one filter matches for a webhook event, you still receive only one webhook event to your endpoint. The matchingFilters array will contain all the filter uuids that successfully matched for this event.

• You can add, update or remove filters via our Dashboard, but you can also do it via GraphQL mutations. See Programmatically Adding and Removing Filters section below.

Regex Examples

• We do case insensitive matching (regex containing iPod vs ipod is equivalent)

• There is a 500 character limit for regex expressions.

• We block regex patterns containing * , but not + . Use .+ instead as a wildcard to match unknown text.

• If the property you are matching against returns an array, we will check each item in the array and check if it matches your regex expression. For example, In the zune example above, podcastSeries.genres returns the array ["PODCASTSERIES_TECHNOLOGY", "PODCASTSERIES_NEWS", "PODCASTSERIES_NEWS_TECH"]. If you add an regex expression that matches for PODCASTSERIES_TECHNOLOGY we will successfully find this match.

AllowList & BlockList

• A useful use case for AllowLists is if you only need to keep track of a very small subset of the 4 million podcasts in Taddy API’s index.

• A useful use of BlockLists is if you have setup a filter and consistently see matches from a specific podcast that you want to exclude from receiving any future webhooks events.

• We match the exact value you provide in these lists against a podcast’s uuid, rssUrl or itunesId exact value and check if its a match.

Examples

• description MATCHES radio|ipod|sony walkman|zune

• podcastSeries.genres MATCHES PODCASTSERIES_TECHNOLOGY

• description MATCHES \b(chris )?lattner\b

• description MATCHES \b(apple|google|tesla|modular|mojo)\b

• podcastSeries.popularityRank MATCHES TOP_(200|1000|2000|3000|4000|5000)

• podcastSeries.genre MATCHES PODCASTSERIES_BUSINESS

• duration MATCHES ^(360[1-9]|36[1-9][0-9]|3[7-9][0-9]{2}|[4-9][0-9]{3}|[1-9][0-9]{4,})$

Regex Breakdown:
- 360[1-9] → 3601-3609
- 36[1-9][0-9] → 3610-3699
- 3[7-9][0-9]{2} → 3700-3999
- [4-9][0-9]{3} → 4000-9999
- [1-9][0-9]{4,} → 10000+

Mock Webhook Event

mutation MockWebhookEvent($webhookId: ID!, $taddyType: String!, $action: WebhookEventActionType!, $contentUuid: String!) {
  mockWebhookEvent(webhookId: $webhookId, contentUuid: $contentUuid, taddyType: $taddyType, action: $action)
}


# input for mockWebhookEvent
{
  "webhookId": "your-webhook-id",
  "taddyType": "podcastseries", # podcastseries, or podcastepisode
  "action": "created", # created, updated, or deleted
  "contentUuid": "content-uuid"
}

Programmatically Adding and Removing Filters

mutation AddWebhookFilter($webhookId: ID!, $filter: WebhookFilterInput!) {
  addWebhookFilter(webhookId: $webhookId, filter: $filter) {
    id
  }
}

mutation UpdateWebhookFilter($webhookId: ID!, $filterUuid: ID!, $filter: WebhookFilterInput!) {
  updateWebhookFilter(webhookId: $webhookId, filterUuid: $filterUuid, filter: $filter) {
    id
  }
}

mutation DeleteWebhookFilter($webhookId: ID!, $filterUuid: ID!) {
  deleteWebhookFilter(webhookId: $webhookId, filterUuid: $filterUuid) {
    id
  }
}

mutation AddUuidToWebhookFilterAllowlist($webhookId: ID!, $filterUuid: ID!, $contentUuid: String!) {
  addUuidToWebhookFilterAllowlist(webhookId: $webhookId, filterUuid: $filterUuid, contentUuid: $contentUuid) {
    uuid
  }
}

mutation DeleteUuidFromWebhookFilterAllowlist($webhookId: ID!, $filterUuid: ID!, $contentUuid: String!) {
  deleteUuidFromWebhookFilterAllowlist(webhookId: $webhookId, filterUuid: $filterUuid, contentUuid: $contentUuid) {
    uuid
  }
}

mutation AddUuidToWebhookFilterBlocklist($webhookId: ID!, $filterUuid: ID!, $contentUuid: String!) {
  addUuidToWebhookFilterBlocklist(webhookId: $webhookId, filterUuid: $filterUuid, contentUuid: $contentUuid) {
    uuid
  }
}

mutation DeleteUuidFromWebhookFilterBlocklist($webhookId: ID!, $filterUuid: ID!, $contentUuid: String!) {
  deleteUuidFromWebhookFilterBlocklist(webhookId: $webhookId, filterUuid: $filterUuid, contentUuid: $contentUuid) {
    uuid
  }
}