Skip to Content

TwentyThree™ API

API Method: /api/album/create

Create a new album or category.


title (required)The album title. All HTML tags will be stripped away from the title.
descriptionDescription of the album. The value can include save HTML tags such as <b> or <p>; however, if any disallowed tags are included, all html with be stripped from the description.
hide_p (deprecated)Should the album/channel be hidden or not. (Only available on 23 Video.)
Default is 0
Allowed values: 0 or 1
user_idThe user's ID. If no user ID is given, the objects will be uploaded anonymously. Requires super, otherwise albums are created by the authenticated user.

Permission level

The minimum required permission level is:


Example XML Response

<response status="ok" permission_level="write" 
  message="The album was successfully created" cached="0">

Example JSON Response

  "status": "ok", 
  "message":"The album was successfully created",
  "album":{"album_id": "123456", "token": "hqzry7xaaekyavpjghpZkt1ykbelKjai"},
  "p": "1",
  "size": "1",
  "site": { ...},
  "endpoint": "/api/album/create"