Creates a new photo album.

This method requires the following permissions: photos.

Parameters

title
string

The title of the album.

description
string

The description of the album.

group_id
integer

If creating an album in a group, the identifier of that group. Omit this parameter to create an album in the current user’s profile.

privacy_view
privacy setting

For a user-owned album, privacy setting (as a JSON object) determining who can view this album. By default, the album is publicly viewable.

privacy_comment
privacy setting

For a user-owned album, privacy setting (as a JSON object) determining who can comment on photos in this album. By default, anyone can comment.

upload_by_admins_only
boolean

For a group-owned album, whether uploading new photos is restricted to group managers.

By default false.

comments_disabled
boolean

For a group-owned album, whether commenting on photos in this album is disabled.

By default false.

Result

A photo album object.

Errors

302
Too many photo albums
Global errors may also occur when calling this method.