Upload Organization Photo

Each organization has a unique logo or image. You can upload and update the organization photo using this API.

Purpose

To upload the brand logo or image of the organization.

Endpoints

  • POST /org/photo

Request Details

Request URL

{api-domain}/crm/{version}/org/photo

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

scope=ZohoCRM.org.{operation_type}

Possible operation types

ALL - Full access to Organization data
CREATE - Upload organization photo
WRITE - Edit organization data

Parameters
  • filefile, mandatory

    Choose the photo you want to upload.

Sample Request

CurlDeluge
Copiedcurl "https://www.zohoapis.com/crm/v8/org/photo"
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-F "file=@img1.png"
Copiedphoto = invokeUrl
[
	url: "https://pbs.twimg.com/profile_images/1212572524128563200/w2ub-ATf_400x400.jpg"
	type: GET
];
photo.setParamName("file");
response = invokeurl
[
	url: "https://www.zohoapis.com/crm/v8/org/photo"
	type: POST
	files: photo
	connection:"crm_oauth_connection"
];

In the request, "file=@img1.png" contains the sample image.

Possible Errors

  • INVALID_DATAHTTP 400

    Invalid file type
    Resolution: The file being uploaded is not an image file. Ensure that the file you are trying to upload is an image file.

  • INVALID_DATAHTTP 400

    The request does not contain any file
    Resolution: You have not added any file to the request. Ensure that you add an image file to the request. Refer to parameters section above.

  • INVALID_DATAHTTP 400

    The request contains more than one file
    Resolution: You have added more than one file to the request. Ensure that you add only one image file to the request. Refer to parameters section above.

  • FILE_SIZE_MORE_THAN_ALLOWED_SIZEHTTP 415

    Please check if the file size is in the correct range
    Resolution: The photo you are trying to upload either exceeds the allowed size(1 MB) or the allowed resolution(10 MP). Ensure that the photo being uploaded is within the prescribed range.

  • CANNOT_PROCESSHTTP 400

    Zia vision rejected the photo
    Resolution: The image could not be uploaded since it was rejected by Zia Image validator. Try uploading another image.

  • INVALID_URL_PATTERNHTTP 404

    Please check if the URL trying to access is a correct one
    Resolution: The request URL specified is incorrect. Specify a valid request URL. Refer to request URL section above.

  • OAUTH_SCOPE_MISMATCHHTTP 401

    Unauthorized
    Resolution: Client does not have ZohoCRM.org.CREATE/ZohoCRM.org.WRITE scope. Create a new client with valid scope. Refer to scope section above.

  • NO_PERMISSIONHTTP 403

    Permission denied to update
    Resolution: The user does not have permission to upload organization photo. Contact your system administrator.

  • INTERNAL_ERRORHTTP 500

    Internal Server Error
    Resolution: Unexpected and unhandled exception in the server. Contact support team.

  • INVALID_REQUEST_METHODHTTP 400

    The http request method type is not a valid one
    Resolution: You have specified an invalid HTTP method to access the API URL. Specify a valid request method. Refer to endpoints section above.

  • AUTHORIZATION_FAILEDHTTP 400

    User does not have sufficient privilege to add organization photo.
    Resolution: The user does not have the permission to add organization photo. Contact your system administrator.

Sample Response

Copied{
	"message": "photo uploaded successfully",
	"details": {},
	"status": "success",
	"code": "SUCCESS",
}