MediaPost Social Network

Up.photos.createAlbum

Creates and returns a new album owned by the current session user. See photo uploads for a description of the upload workflow. The only storable values returned from this call are aid and owner. No relationships between them are storable.

Parameters

Type	Name	Required	Description
string	api_key	✔	The application key associated with the calling application.
string	community	✔	Community system name. Use up.community.getList method to retrieve available communities.
string	session_key	✔	The session key of the logged in user.
string	sig	✔	An MD5 hash of the current request and your secret key, as described in the authentication guide.
string	format		Desired response format. Either XML (default) or JSON.
string	name	✔	The album name.
string	description		The album description.

Example return XML

<?xml version="1.0" encoding="UTF-8"?>
<photos_createAlbum_response>
    <aid>34595963571485</aid>
    <cover_pid>0</cover_pid>
    <owner>8055</owner>
    <name>Films you will never see</name>
    <created>1132553109</created>
    <description>No I will not make out with you</description>
    <link>http://my.mashable.com/photo/album/id/2002205</link>
    <size>0</size>
</photos_createAlbum_response>

Response

The returned cover_pid is always 0.

Error codes

Code	Description
1	An unknown error occurred. Please resubmit the request.
2	The service is not available at this time.
4	The application has reached the maximum number of requests allowed. More requests are allowed once the time window has completed.
5	The request came from a remote address not allowed by this application.
100	One of the parameters specified was missing or invalid.
101	The api key submitted is not associated with any known application.
102	The session key was improperly submitted or has reached its timeout. Direct the user to log in again to obtain another key.
104	Incorrect signature.