benecaster_follower_signed_up
Fires after a free follower token is created, before the welcome email is dispatched. Fires inside the signup handler after the token row is inserted and the WordPress user account is created or resolved. Use to trigger welcome sequences, update CRM records, sync to an email marketing platform, or log the signup event.
This hook does not fire for returning followers — if the submitted email already has an active follower token for the show, the signup is treated as a no-op, no duplicate token is inserted, and this hook does not fire. It fires for both signup paths: `[benecaster_follower_signup]` shortcode submissions and direct service calls from custom UIs.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
$user_id |
int |
— | WordPress user ID of the new follower |
$show_id |
int |
— | Post ID of the show the follower signed up for |
$tier_slug |
string |
— | Tier slug assigned to the follower token (default: 'follower') |
Examples
Sync new follower to email marketing platform
add_action( 'benecaster_follower_signed_up', function ( int $user_id, int $show_id, string $tier_slug ): void {
$user = get_userdata( $user_id );
if ( ! $user instanceof \WP_User ) {
return;
}
my_esp_tag_contact( $user->user_email, 'benecaster_follower' );
}, 10, 3 );Log follower signup to analytics service
add_action( 'benecaster_follower_signed_up', function ( int $user_id, int $show_id, string $tier_slug ): void {
wp_remote_post( MY_ANALYTICS_ENDPOINT, [
'body' => wp_json_encode( [
'event' => 'follower_signup',
'show_id' => $show_id,
'tier' => $tier_slug,
] ),
'headers' => [ 'Content-Type' => 'application/json' ],
] );
}, 10, 3 );Notes
This hook does not fire for returning followers — if a user already has an active follower token for the show the signup is a silent no-op. The welcome email has been queued but not yet dispatched when this hook fires. The $tier_slug parameter defaults to 'follower' unless overridden by the benecaster_follower_tier_slug filter. This is a Free hook — it fires regardless of license status.
