Add a person to a photo. Coordinates and sizes of boxes are optional; they are measured in pixels, based on the 500px image size shown on individual photo pages.


This method requires authentication with 'write' permission.

Note: This method requires an HTTP POST request.


api_key (Required)
Your API application key. See here for more details.
photo_id (Required)
The id of the photo to add a person to.
user_id (Required)
The NSID of the user to add to the photo.
person_x (Optional)
The left-most pixel co-ordinate of the box around the person.
person_y (Optional)
The top-most pixel co-ordinate of the box around the person.
person_w (Optional)
The width (in pixels) of the box around the person.
person_h (Optional)
The height (in pixels) of the box around the person.

Example Response

This method has no specific response - It returns an empty success response if it completes without error.

Error Codes

1: Person not found
The NSID passed was not a valid user id.
2: Photo not found
The photo id passed was not a valid photo id.
3: User cannot add this person to photos
The person being added to the photo does not allow the calling user to add them.
4: User cannot add people to that photo
The owner of the photo doesn't allow the calling user to add people to their photos.
5: Person can't be tagged in that photo
The person being added to the photo does not want to be identified in this photo.
6: Some co-ordinate paramters were blank
Not all of the co-ordinate parameters (person_x, person_y, person_w, person_h) were passed with valid values.
7: Can't add that person to a non-public photo
You can only add yourself to another member's non-public photos.
8: Too many people in that photo
The maximum number of people has already been added to the photo.
95: SSL is required
SSL is required to access the Flickr API.
96: Invalid signature
The passed signature was invalid.
97: Missing signature
The call required signing but no signature was sent.
98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
99: User not logged in / Insufficient permissions
The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100: Invalid API Key
The API key passed was not valid or has expired.
105: Service currently unavailable
The requested service is temporarily unavailable.
106: Write operation failed
The requested operation failed due to a temporary issue.
111: Format "xxx" not found
The requested response format was not found.
112: Method "xxx" not found
The requested method was not found.
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.

API Explorer

API Explorer :