Sample Request

POST /api/v1/employees/1/photo/ HTTP/1.0
Host: {companyDomain}.bamboohr.com
Content-Type: multipart/form-data; boundary=----BambooHR-MultiPart-Mime-Boundary----
Content-Length: 520
 
------BambooHR-MultiPart-Mime-Boundary----
Content-Disposition: form-data; name="file"; filename="photo.jpg"
Content-Type: text/plain
 
... binary file data ...
 
------BambooHR-MultiPart-Mime-Boundary------

Notes

The width and height of the photo must be the same number of pixels.

The API user must have photo uploading permission.

The source photo must be a jpg, gif, or png.

The photo file may not be larger than 20MB.

The file upload methods accept multi-part forms. To build a multi-part form concatenate the individual sections together separated by a boundary. Then take the length of the resulting body and use that as the Content-Length for the submission.