Title: wp_ajax_add_user
Published: April 25, 2014
Last modified: May 20, 2026

---

# wp_ajax_add_user( string $action )

## In this article

 * [Parameters](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#wp--skip-link--target)

Handles adding a user via AJAX.

## 󠀁[Parameters](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#parameters)󠁿

 `$action`stringrequired

Action to perform.

## 󠀁[Source](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#source)󠁿

    ```php
    function wp_ajax_add_user( $action ) {
    	if ( empty( $action ) ) {
    		$action = 'add-user';
    	}

    	check_ajax_referer( $action );

    	if ( ! current_user_can( 'create_users' ) ) {
    		wp_die( -1 );
    	}

    	$user_id = edit_user();

    	if ( ! $user_id ) {
    		wp_die( 0 );
    	} elseif ( is_wp_error( $user_id ) ) {
    		$response = new WP_Ajax_Response(
    			array(
    				'what' => 'user',
    				'id'   => $user_id,
    			)
    		);
    		$response->send();
    	}

    	$user_object   = get_userdata( $user_id );
    	$wp_list_table = _get_list_table( 'WP_Users_List_Table' );

    	$role = current( $user_object->roles );

    	$response = new WP_Ajax_Response(
    		array(
    			'what'         => 'user',
    			'id'           => $user_id,
    			'data'         => $wp_list_table->single_row( $user_object, '', $role ),
    			'supplemental' => array(
    				'show-link' => sprintf(
    					/* translators: %s: The new user. */
    					__( 'User %s added' ),
    					'<a href="#user-' . $user_id . '">' . $user_object->user_login . '</a>'
    				),
    				'role'      => $role,
    			),
    		)
    	);
    	$response->send();
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-admin/includes/ajax-actions.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-admin/includes/ajax-actions.php#L1750)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-admin/includes/ajax-actions.php#L1750-L1796)

## 󠀁[Related](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#related)󠁿

| Uses | Description | 
| [WP_List_Table::single_row()](https://developer.wordpress.org/reference/classes/wp_list_table/single_row/)`wp-admin/includes/class-wp-list-table.php` |

Generates content for a single row of the table.

  | 
| [_get_list_table()](https://developer.wordpress.org/reference/functions/_get_list_table/)`wp-admin/includes/list-table.php` |

Fetches an instance of a [WP_List_Table](https://developer.wordpress.org/reference/classes/wp_list_table/) class.

  | 
| [edit_user()](https://developer.wordpress.org/reference/functions/edit_user/)`wp-admin/includes/user.php` |

Edit user settings based on contents of $_POST

  | 
| [WP_Ajax_Response::__construct()](https://developer.wordpress.org/reference/classes/wp_ajax_response/__construct/)`wp-includes/class-wp-ajax-response.php` |

Constructor – Passes args to [WP_Ajax_Response::add()](https://developer.wordpress.org/reference/classes/wp_ajax_response/add/).

  | 
| [current_user_can()](https://developer.wordpress.org/reference/functions/current_user_can/)`wp-includes/capabilities.php` |

Returns whether the current user has the specified capability.

  | 
| [__()](https://developer.wordpress.org/reference/functions/__/)`wp-includes/l10n.php` |

Retrieves the translation of $text.

  | 
| [check_ajax_referer()](https://developer.wordpress.org/reference/functions/check_ajax_referer/)`wp-includes/pluggable.php` |

Verifies the Ajax request to prevent processing requests external of the blog.

  | 
| [get_userdata()](https://developer.wordpress.org/reference/functions/get_userdata/)`wp-includes/pluggable.php` |

Retrieves user info by user ID.

  | 
| [wp_die()](https://developer.wordpress.org/reference/functions/wp_die/)`wp-includes/functions.php` |

Kills WordPress execution and displays HTML page with an error message.

  | 
| [is_wp_error()](https://developer.wordpress.org/reference/functions/is_wp_error/)`wp-includes/load.php` |

Checks whether the given variable is a WordPress Error.

  |

[Show 6 more](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#)

## 󠀁[Changelog](https://developer.wordpress.org/reference/functions/wp_ajax_add_user/?output_format=md#changelog)󠁿

| Version | Description | 
| [3.1.0](https://developer.wordpress.org/reference/since/3.1.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fwp_ajax_add_user%2F)
before being able to contribute a note or feedback.