Create picture

Creates the properties and relationships of a picture object for Dynamics 365 Business Central.

HTTP request

Replace the URL prefix for Dynamics 365 Business Central depending on environment following the guideline.

PATCH businesscentralPrefix/companies({companyId})/items({itemId})/picture({pictureId})/content
PATCH businesscentralPrefix/companies({companyId})/vendors({vendorId})/picture({pictureId})/content
PATCH businesscentralPrefix/companies({companyId})/employees({employeeId})/picture({pictureId})/content
PATCH businesscentralPrefix/companies({companyId})/customers({customerId})/picture({pictureId})/content

Request headers

Header Value
Authorization Bearer {token}. Required.
Content-Type application/octet-stream
If-Match *

Request body

Raw picture binary data.


If successful, this method returns a 204 No Content response code. It does not return anything in the response body.



Here is an example of the request.

PATCH https://{businesscentralPrefix}/api/v1.0/companies(companyId)/items(itemId)/picture(itemId)/content


No content.

See also

Tips for working with the APIs
Error Codes
Get Picture
Update Picture
Delete Picture