Purpose

Fires after mam_user_roles_manager finishes creating a user via the mam-main registration flow. Use it for post-registration cleanup — persist app-user metadata, queue welcome flows, sync with external systems.

Distinct from WP’s native user_register action: this fires only when the user was created through mam-main (not through wp-admin → Users → Add New, for example).

Signature

$result = apply_filters(
    'mam_user_roles_after_create_user',
    array $result,     // pass-through accumulator (starts empty)
    int   $user_id
);

Returns: array — the pass-through $result (typically unchanged). The user id is the second argument, not the filtered value.

Example: persist a custom app-user metadata key

add_filter( 'mam_user_roles_after_create_user',
    function ( array $result, int $user_id ): array {

        // Persist an app-user-only flag.
        update_user_meta( $user_id, 'my_plugin_signup_source', 'app' );

        // Trigger a downstream side effect.
        do_action( 'mam_notification_send_message', array(
            'message_type' => 'mam-my-plugin-welcome_email',
            'recipient_id' => $user_id,
        ) );

        return $result;
    },
    10, 2
);

Related identity-lifecycle hooks

Gotchas

• Fires only for mam-main registrations. WP-admin user creation doesn’t fire this. If you need to handle every user creation, hook WP’s user_register instead.
• The pass-through $result array is the canonical return. Return it (usually unchanged); the user id is the second argument, not the filtered value.
• No registration payload is passed. Only $user_id reaches your callback — look up any signup context from usermeta or the request yourself.
• The bundled welcome email fires from the registration flow itself via mam-user-roles-welcome_email. Don’t double-send by firing the same notification from this filter.

Related articles

• Recipe: Customize onboarding
• Hook: mam_user_logged_in
• Hook: mam_add_fields_to_user_profile
• Hook: mam_user_roles_save_addl_user_profilefield{key}
• Hook: mam_notification_send_message

Metadata