Moderate Emails in a Group

Purpose

This API moderates the email that is held for moderation and delivers the email to the member accounts. 

OAuth Scope

Use the scope

ZohoMail.organization.groups.ALL (or) ZohoMail.organization.groups.UPDATE

to generate the Authtoken.

ALL - Full access to groups.

UPDATE - Moderates the emails in a group.

Request URL

Method: PUT

https://mail.zoho.com/api/organization/{zoid}/groups/{zgid}/messages

Request Body (JSON Object)

  • messageList* JSON Array of long
    • This parameter needs to be passed as an array of single or multiple message IDs that need to be moderated.
    • messageId is a unique identifier assigned to a message or email. This can be retrieved from the Get All Mails Held for Moderation API.
  • status* string
    • This parameter specifies the status of the email at the end of moderation.
    • The possible values can be:
      • accept
      • reject

 

* - Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

Sample Request

Copiedcurl "https://mail.zoho.com/api/organization/N****C0CM/groups/567888*****/messages" \
-X PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****" \

-d '{
    "messageList": [
        "1695363808702000001"
    ],
    "status": "reject"
}'

Sample Request Body

Copied{
    "status": {
        "code": 200,
        "description": "success"-d '{
    "messageList": [
        "1695363808702000001"
    ],
    "status": "reject"
}
    }
}

Sample Response

Copied{
    "status": {
        "code": 200,
        "description": "success"
    }
}