The Salesforce Developers website will undergo maintenance on May 29, 2024 from 3:00 a.m. UTC to 10:00 a.m. UTC. The maintenance process may affect the availability of our documentation. Please plan accordingly.

POST /asset/v1/content/categories

Creates a category (folder) in Content Builder.

NameTypeDescription
NamestringRequired. Name of the category.
ParentIdnumberRequired. ID of the parent category.
CategoryTypestringThe 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.
EnterpriseIdnumberID of the enterprise this business unit belongs to.
MemberIdnumberID of the member who creates the category.
SharingPropertiesobjectAllows 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.SharedWithobjectList 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.SharingTypestringIndicates the permission that you are granting to the list of MIDs in sharedWith. The only possible value for categories is edit.
DescriptionstringDescription of the category.
StatusNameTypeDescription
200  A single category
 IdstringSystem-assigned ID for the category.
 NamestringName of the category.
 ParentIdnumberID of the parent category.
 CategoryTypestringThe type of category, either asset or asset-shared.
 MemberIdnumberID of the member who creates the category.
 EnterpriseIdnumberID of the enterprise this business unit belongs to.
 SharingPropertiesobjectStores the MIDs of business units this category is shared with and the sharing type. Only included in the response if CategoryType is asset-shared.
 MetaobjectMeta 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
 MessagestringInsufficient privileges
 ErrorCodenumber20002
    
500  Internal server error
 MessagestringNo message
 ErrorCodenumber10000

Example Non-Shared Category Request

Example Non-Shared Category Response

Example Shared Category Request

Example Shared Category Response