Add User
POST/v1/users
Add an User to the Joomla site.
GET never returns passwords. The create controller copies a supplied password into confirmation. PATCH preserves omitted passwords and has special handling for omitted group memberships. Filters such as registrationDateStart and lastVisitDateEnd take RFC3339 date-time values, unlike many administrator calendar writes. User plugins and custom fields can extend the form. Grant integrations only the group-management permissions they need.
Managing user groups and creating, editing or deleting viewing access levels requires core.admin on com_users. A general edit permission is insufficient for these operations. Access-level rules is an ID array for POST and a JSON-encoded array string for PATCH; supplying an array to PATCH raises TypeError. The base edit check requires core.manage and record core.edit, or core.edit.own with a matching owner; component overrides take precedence. Omitted SERVER_UTC/USER_UTC calendar values are restored from the stored UTC values after validation, avoiding a second timezone conversion.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 406
- 500
The created User.
Invalid parameters, form validation or save failure.
Missing or invalid API authentication.
Access denied by ACL.
Route, record or task not found.
Unsupported Accept header.
Model or server error.