Skip to main content

benecaster_feed_link_requested

Action Free

Fires when a podcaster asks for a subscriber’s existing feed URL to be emailed to them, with Email link on the subscriber’s panel or POST /subscribers/{id}/email-feed-link. Nothing has been reset: the subscriber’s URL and podcast app are unchanged. Benecaster’s own listener on this hook sends the Feed Link email (feed_link).

The URL is not an argument. Benecaster’s listener recovers it itself, so a working feed token never passes through a hook an add-on might log. If your callback genuinely needs the URL, get it with TokenManager::feed_url_for(), and do not log or store it.

The hook only fires once Benecaster has confirmed the URL can be recovered and the subscriber has an email address. When either check fails, the endpoint answers 409 and the hook does not fire.

Parameters

Name Type Default Description
$token_id int — ID of the token record
$user_id int — WordPress user ID of the subscriber
$show_id int — ID of the show
$custom_message string — Note the podcaster added for the email body; may be empty

Examples

Record each re-send in an audit log

add_action( 'benecaster_feed_link_requested', function ( $token_id, $user_id, $show_id, $custom_message ) {
    my_addon_audit_log( 'feed_link_resent', [
        'token_id' => $token_id,
        'user_id'  => $user_id,
        'show_id'  => $show_id,
        'by'       => get_current_user_id(),
    ] );
}, 10, 4 );

Need this built rather than just documented? See our services →