Creates a new tag on a photo.

You can only create tags on photos owned or uploaded to a group by the current user, or owned by a group managed by the current user.

This method requires the following permissions: photos.

Parameters

photo_id
string

Identifier of the photo.

user_id
integer

Identifier of the user to tag. The user must be the current user’s friend.

name
string

The name to tag. Pass instead of user_id to create a tag with just a name, without linking to anyone’s profile.

x1
float (0..1)

X coordinate of the top left corner of the tag area.

y1
float (0..1)

Y coordinate of the top left corner of the tag area.

x2
float (0..1)

X coordinate of the bottom right corner of the tag area.

y2
float (0..1)

Y coordinate of the bottom right corner of the tag area.

Result

Returns the identifier of the new tag.

Errors

Global errors may occur when calling this method.