Add Contacts Category
POST/v1/contacts/categories
Add a Contacts Category to the Joomla site.
Route defaults fix extension to com_content, com_contact, com_banners or com_newsfeeds. Do not move a category between component trees by changing extension. lft, rgt and level are maintained by Joomla.
The collection supports filter[state], an integer passed to the publication-state filter. For example, GET /content/categories?filter[state]=1 selects published article categories.
For tree positioning, the controller reads location and location_reference from the JSON body and calls setLocation after saving. location accepts before, after, first-child or last-child; the reference is the category ID, with parent_id used when no explicit reference is provided. Changing ordinary fields and positioning the record are separate steps, so read back the parent and ordering even when the initial save succeeds. Component plugins can add options to the base form. 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 Contacts Category.
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.