Add User Signature


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

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
      • - 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 "" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken ***" 
-d '{
   "name": "New Signature Added",
    "content": "Regards, John.",
    "position": 0,
    "assignUsers": ","

Sample Success Response

   "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

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

Sample Failure Response for Invalid Input

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