Add User Signature

Purpose

This API allows users to add a specific email signature.

OAuth Scope

Use the scope

ZohoMail.accounts.ALL (or) ZohoMail.accounts.CREATE 

to generate the Authtoken.

ALL - Full access to the accounts

CREATE - Create a user signature.

Request URL 

Method: POST

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

Request Body (JSON Object)

  • name* string
    • Specifies the name of the signature to be added.
  • content* string
    • Specifies the content of the signature.
  • assignUsers string
    • Provide the email addresses of the users to which this signature should be assigned, separated by commas.
  • position* int
    • Specifies the preferred position of the added signature.
    • The possible value can be
      • 0 - Place the signature below the quoted content.
      • 1 - 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 POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken ***" \
-d '{
   "name": "New Signature Added",
    "content": "Regards, John.",
    "position": 0,
    "assignUsers": "john@zylker.com,john-test@zylker.com"
}'

Sample Success Response

Copied{
   "status": {
       "code": 201,
       "description": "Created"
   },
   "data": {
       "name": "New Signature Added",
       "signatureType": "USER_SIGNATURE",
       "id": "2442552000000433009",
       "position": 0,
       "content": "Regards, John."
   }
}

Sample Failure Response for Duplicate Name

Copied{
   "status": {
       "code": 500,
       "description": "Internal Error"
   },
   "data": {
       "moreInfo": "The name you have entered is already exists."
   }
}

Sample Failure Response for Invalid Input

Copied{
   "status": {
       "code": 400,
       "description": "Invalid Input"
   },
   "data": {}
}