Skip to content

Users Endpoints

Fresh

Source: MainWP Users API

Endpoints

MethodPathDescription
GET/usersList users (filter by clients, groups, websites, roles)
POST/users/createCreate user (username, email, password, role, name fields)
PUT/PATCH/users/{id_or_domain}/{user_id}/editModify user profile
DELETE/users/{id_or_domain}/{user_id}/deleteRemove user
PUT/PATCH/users/update-admin-passwordChange admin passwords across sites
POST/users/importBulk import via CSV

CSV Import Format

10 columns per row:

ColumnDescription
usernameWordPress username
emailUser email
first_nameFirst name
last_nameLast name
user_urlWebsite URL
passwordUser password
send_passwordSend notification
roleWordPress role
select_sitesTarget site IDs
select_groupsTarget group IDs

Use has_header parameter to control header row skipping.

Example: Create User

bash
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "newuser", "email": "user@example.com", "password": "securepass", "role": "editor", "select_sites": [1, 2]}' \
  "https://your-dashboard.com/wp-json/mainwp/v2/users/create"