{"id":1214,"date":"2023-07-17T06:45:06","date_gmt":"2023-07-17T06:45:06","guid":{"rendered":"https:\/\/feeder.co\/help\/?p=1214"},"modified":"2026-02-07T13:29:38","modified_gmt":"2026-02-07T13:29:38","slug":"build-your-own-integrations-using-webhooks","status":"publish","type":"post","link":"https:\/\/feeder.co\/help\/account\/automation\/build-your-own-integrations-using-webhooks\/","title":{"rendered":"Build your own integrations using Webhooks"},"content":{"rendered":"\n
The “Post to Webhook” rule enables you to automate the process of sending new RSS feed posts to your specified webhook endpoint, as soon as they become available. You can also fine-tune what posts are being sent by setting up keywords to filter on. When a new post matches your criteria, it will be sent to your webhook endpoint as a JSON formatted POST request.<\/p>\n\n\n\n
JSON payload format<\/strong><\/h2>\n\n\n\n
Each POST request sent to your webhook will contain two main elements: the post<\/code> and the feed<\/code>.<\/p>\n\n\n\n
It also contains metadata elements to identify the webhook message. The version<\/code> field states which version of the Feeder webhook API is being sent. The version is constant to 2023-06-26<\/code> and will be updated if breaking changes are made.<\/p>\n\n\n\n
{\n \"version\": \"2023-06-26\",\n \"message_id\": \"a unique UUID for this message, will be constant during retries\",\n \"feed\": { ... },\n \"post\": { ... }\n}<\/code><\/pre>\n\n\n\n
The post<\/code> element contains information about the individual post:<\/p>\n\n\n\n
{\n \"id\": \"The unique identifier of the post\",\n \"title\": \"The title of the post\",\n \"url\": \"The URL where the post can be accessed\",\n \"published\": \"The date and time when the post was published\",\n \"content\": \"The content of the post\",\n \"audio_url\": \"link to mp3 attached to post (if present)\",\n \"image_url\": \"link to image attached to post (if present)\n}<\/code><\/pre>\n\n\n\n
Note: published<\/code> will be null<\/code> if the RSS feed did not specify a valid published date.<\/p>\n\n\n\n
The feed<\/code> element provides information about the feed from which the post originates:<\/p>\n\n\n\n
{\n \"id\": \"The unique identifier of the feed\",\n \"source_url\": \"The URL of the source, for example RSS\/Atom feed URL\",\n \"public_url\": \"The source's self identified public URL\",\n \"title\": \"The title of the feed\",\n \"favicon\": \"The URL of the feed's favicon\"\n}<\/code><\/pre>\n\n\n\n
We might make additions to these objects in the future. If you are missing anything, please let us know.<\/p>\n\n\n\n
Retry logic<\/strong><\/h2>\n\n\n\n
We have built-in robustness with a retry mechanism. If a POST request does not receive a HTTP response code between 200 and 399, we will attempt to resend it based on a specific schedule, defined in seconds:<\/p>\n\n\n\n
\n
Retry 1: After 5 seconds<\/li>\n\n\n\n
Retry 2: After 30 seconds<\/li>\n\n\n\n
Retry 3: After 60 seconds<\/li>\n\n\n\n
Retry 4: 5 minutes<\/li>\n\n\n\n
Retry 5: 10 minutes<\/li>\n\n\n\n
Retry 6: 30 minutes<\/li>\n\n\n\n
Retry 7: 30 minutes<\/li>\n\n\n\n
Retry 8: 30 minutes<\/li>\n<\/ul>\n\n\n\n
Please note that this retry mechanism is only triggered upon real post events and it does not apply to test notifications. The timings are also subject to change.<\/p>\n\n\n\n
Debugging<\/strong><\/h2>\n\n\n\n
If errors occur you can find them in the action run log. Simply visit the rule that is not working and press “Open error log”<\/p>\n\n\n\n<\/figure>\n\n\n\n
There you will see more details about the webhooks that failed.<\/p>\n\n\n\n<\/figure>\n\n\n\n
Setting up your webhook<\/strong><\/h2>\n\n\n\n<\/figure>\n\n\n\n
![\"\"](\"https:\/\/feeder.co\/help\/wp-content\/uploads\/sites\/2\/2023\/06\/image-1024x379.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/feeder.co\/help\/wp-content\/uploads\/sites\/2\/2023\/06\/Screenshot-2023-06-26-at-14.51.08-895x1024.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/feeder.co\/help\/wp-content\/uploads\/sites\/2\/2023\/06\/webhook_setup-1024x586.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/feeder.co\/help\/wp-content\/uploads\/sites\/2\/2023\/07\/2026-02-07-at-10.35.15-1024x715.png\")
<\/figure>\n\n\n\n