Update User Signature

Purpose

This API is used to update a specific email signature.

OAuth Scope

Use the scope

ZohoMail.accounts.ALL (or) ZohoMail.accounts.UPDATE

to generate the Authtoken.

ALL - Full access to the accounts.

UPDATE - Update user signatures.

Request URL 

Method: PUT

https://mail.zoho.com/api/accounts/signature

Request Body (JSON Object)

  • name* string
    • Specifies the name to be updated in the signature.
  • content* string
    • Specifies the content to be updated in the signature.
  • assignUsers string
    • Provide the email addresses of the users to which this signature should be assigned, separated by commas.
  • unassignUsers string
    • Provide the email addresses of the users to which this signature should be unassigned, separated by commas.
  • id* long
    • This is a unique key used to identify the specific signature to be updated.
  • position* int
    • Specifies the preferred position of the updated signature.
    • The possible value can be
      • - Place the signature below the quoted content.
      • - Place the signature above the quoted content.

 

* - Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

Sample Request

Copiedcurl "https://mail.zoho.com/api/accounts/signature" \
-X PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken ***" \
-d '{
   "name": "New Signature Updated",
    "content": "Regards, Paula.",
    "position": 0,
    "id": "2442552000000433009"
}'

Sample Success Response

Copied{
    "status": {
        "code": 200,
        "description": "success"
    },
    "data": {
        "name": "New Signature Updated",
        "signatureType": "USER_SIGNATURE",
        "id": "2442552000000433009",
        "position": 1,
        "content": "Regards, Paula."
    }
}

Sample Failure Response

Copied{
    "status": {
        "code": 500,
        "description": "Internal Error"
    },
    "data": {
        "moreInfo": "The input passed is invalid"
    }
}