Get Notification Details

Purpose

To get the details of the notifications enabled by the user.

Request Details

Request URL

{api-domain}crm/{version}/actions/watch
 

Supported modules

Leads, Accounts, Contacts, Deals, Campaigns, Tasks, Cases, Meetings, Calls, Solutions, Products, Vendors, Price Books, Quotes, Sales Orders, Purchase Orders, Invoices, Appointments, Appointments Rescheduled History, Services, and Custom

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

scope=ZohoCRM.notifications.{operation_type}

Possible operation types

ALL - Full access to the record
READ - Get notification details

Parameters

  • pageInteger, optional

    To get the list of records from the respective pages. Default value is 1.
    Possible values: Integer values. Example: 1(or)4(or)6

  • per_pageInteger, optional

    To get the list of records available per page. Default value is 200.
    Possible values: Integer values. Example: 200(or)400

  • channel_idInteger, mandatory

    Specify the unique ID of the notification channel.
    Possible values: Channel ID. Example: 1000000068001

  • modulestring, optional

    Specify the API name of the module for which the notification is enabled.
    Possible values: Module API names. Example: Leads

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v7/actions/watch"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Note

  • Use the page and per_page parameter to fetch records according to their position in the CRM. Let's assume that the user has to fetch 400 records. The maximum number of records that one can get for an API call is 200. So, for records above the 200th position, they cannot be fetched. By using the page (1, 2, 3 and 4) and per_page (100) parameter, the user can fetch all 400 records using 4 API calls.

Sample Response

Copied{
    "watch": [
        {
            "notify_on_related_action": false,
            "channel_expiry": "2023-08-02T16:51:03-11:00",
            "return_affected_field_values": false,
            "resource_uri": "https://www.zohoapis.com/crm/v2/Leads",
            "resource_id": "554023000000000125",
            "notify_url": "https://webhook.site/2c9xxx0fa9",
            "resource_name": "Leads",
            "fields": null,
            "notification_condition": [
                {
                    "field_selection": {
                        "group_operator": "and",
                        "group": [
                            {
                                "field": {
                                    "api_name": "Last_Name",
                                    "id": "554023000000000559"
                                },
                                "group_operator": null,
                                "group": null
                            },
                            {
                                "field": {
                                    "api_name": "Full_Name",
                                    "id": "554023000000000597"
                                },
                                "group_operator": null,
                                "group": null
                            }
                        ]
                    },
                    "module": {
                        "api_name": "Leads",
                        "id": "554023000000000125"
                    },
                    "type": "field_selection"
                }
            ],
            "channel_id": "1000000068001",
            "events": [
                "Leads.edit",
                "Leads.create",
                "Leads.delete"
            ],
            "token": "xyz"
        },
        {
            "notify_on_related_action": false,
            "channel_expiry": "2023-08-11T02:12:33-11:00",
            "return_affected_field_values": false,
            "resource_uri": "https://www.zohoapis.com/crm/v2/Contacts",
            "resource_id": "554023000000000129",
            "notify_url": "https://webhook.site/2c9axx20fa9",
            "resource_name": "Contacts",
            "fields": null,
            "notification_condition": null,
            "channel_id": "10000",
            "events": [
                "Contacts.create"
            ],
            "token": "deals.all.notif"
        },
        {
            "notify_on_related_action": false,
            "channel_expiry": "2023-08-11T02:13:01-11:00",
            "return_affected_field_values": false,
            "resource_uri": "https://www.zohoapis.com/crm/v2/Deals",
            "resource_id": "554023000000000131",
            "notify_url": "https://webhook.site/2c9a0xx20fa9",
            "resource_name": "Deals",
            "fields": null,
            "notification_condition": [
                {
                    "field_selection": {
                        "group_operator": "or",
                        "group": [
                            {
                                "field": {
                                    "api_name": "Stage",
                                    "id": "554023000000000525"
                                },
                                "group_operator": null,
                                "group": null
                            },
                            {
                                "group_operator": "or",
                                "group": [
                                    {
                                        "field": {
                                            "api_name": "Account_Name",
                                            "id": "554023000000000523"
                                        },
                                        "group_operator": null,
                                        "group": null
                                    },
                                    {
                                        "field": {
                                            "api_name": "Lead_Source",
                                            "id": "554023000000000535"
                                        },
                                        "group_operator": null,
                                        "group": null
                                    }
                                ]
                            }
                        ]
                    },
                    "module": {
                        "api_name": "Deals",
                        "id": "554023000000000131"
                    },
                    "type": "field_selection"
                }
            ],
            "channel_id": "10000",
            "events": [
                "Deals.edit",
                "Deals.create",
                "Deals.delete"
            ],
            "token": "deals.all.notif"
        }
    ],
    "info": {
        "per_page": 200,
        "count": 3,
        "page": 1,
        "more_records": false
    }
}