wp_create_user_request()

wp_create_user_request() — Creates and logs a user request to perform a specific action. Requests are stored inside a post type named user_request since they can apply to both users on the site, or guests without a user account.

Inputs: $email_address (string): User email address. This can be the address of a registered or non-registered user. $action_name (string): Name of the action that is being confirmed. Required. $request_data (array): Misc data you want to send with the verification request and pass to the actions once the request is confirmed. $status (string): Optional request status (pending or confirmed). Default ‘pending’.

Returns int|WP_Error: Returns the request ID if successful, or a WP_Error object on failure.