# /api/users/new Documentation Needs Clarification

**URL:** <https://forum.mautic.org/t/api-users-new-documentation-needs-clarification/34613>\
**Category:** Documentation\
**Created:** [January 3, 2025, 3:22pm UTC](https://forum.mautic.org/t/api-users-new-documentation-needs-clarification/34613 "2025-01-03T15:22:42Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![gem](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/gem/32/12648_2.png) [@gem](https://forum.mautic.org/u/gem)\
**Post date:** [January 3, 2025, 3:22pm UTC](https://forum.mautic.org/t/api-users-new-documentation-needs-clarification/34613/1 "2025-01-03T15:22:42Z")

</div>

Should read something like this:

**Post Parameters**

| Name | Description |
| --- | --- |
| username\* | string |
| firstName\* | string |
| lastName\* | string |
| email\* | string |
| position | string |
| role\* | int |
| timezone | string |
| onlineStatus | string |
| signature | string |
| plainPassword\* | object {“password”:string,“confirm”:string} |

I had to dig into the UserApiControllerFunctionalTest.php to figure this out…