POST /asset/v1/content/categories
Creates a category (folder) in Content Builder.
| Name | Type | Description |
|---|---|---|
| Name | string | Required. Name of the category. |
| ParentId | number | Required. ID of the parent category. |
| CategoryType | string | The type of category, either asset or asset-shared, which is automatically set to the CategoryType of the parent category. If set to asset-shared, include the SharingProperties in the call. |
| EnterpriseId | number | ID of the enterprise this business unit belongs to. |
| MemberId | number | ID of the member who creates the category. |
| SharingProperties | object | Allows you to share categories with one or more business units that have Content Builder Sharing enabled. See Sharing for additional information. Stores the MIDs of business units this category is shared with and the sharing type. Only included in the response if CategoryType is asset-shared. |
| SharingProperties.SharedWith | object | List of up to 100 MID IDs the category is shared with. To share the category with all business units in the enterprise, and if your account has access to Content Builder Across Enterprise Sharing, set this to 0. SharedWith can’t contain 0 and other MIDs simultaneously. Since shared categories live in and are owned by the enterprise business unit, don't include the enterprise business unit in the SharedWith property. |
| SharingProperties.SharingType | string | Indicates the permission that you are granting to the list of MIDs in sharedWith. The only possible value for categories is edit. |
| Description | string | Description of the category. |
| Status | Name | Type | Description |
|---|---|---|---|
| 200 | A single category | ||
| Id | string | System-assigned ID for the category. | |
| Name | string | Name of the category. | |
| ParentId | number | ID of the parent category. | |
| CategoryType | string | The type of category, either asset or asset-shared. | |
| MemberId | number | ID of the member who creates the category. | |
| EnterpriseId | number | ID of the enterprise this business unit belongs to. | |
| SharingProperties | object | Stores the MIDs of business units this category is shared with and the sharing type. Only included in the response if CategoryType is asset-shared. | |
| Meta | object | Meta is used much like the data attribute on CMS assets but for internal functionality in Content Builder. If meta is returned, be sure to pass it through the API. | |
| 403 | Unauthorized | ||
| Message | string | Insufficient privileges | |
| ErrorCode | number | 20002 | |
| 500 | Internal server error | ||
| Message | string | No message | |
| ErrorCode | number | 10000 |
Example Non-Shared Category Request
Example Non-Shared Category Response
Example Shared Category Request
Example Shared Category Response