Get Webform A/B Testing Visitors Count

Purpose

To retrieve the visitor count of Webform A/B Testing configurations in your Zoho CRM organization. This includes all tests in your organization: those that are currently running as well as completed ones.

Endpoints

  • GET /settings/AB_testing/actions/visitors
  • GET /settings/AB_testing/{AB_testing_ID}/actions/visitors

Request Details

Request URL

To retrieve visitors count of all Webform A/B Testings:
{api-domain}/crm/{version}/settings/AB_testing/actions/visitors

To retrieve visitors count of a specific Webform A/B Testing:
{api-domain}/crm/{version}/settings/AB_testing/{AB_testing_ID}/actions/visitors

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

ZohoCRM.settings.abtest.ALL
(or)
ZohoCRM.settings.abtest.READ

Parameters

  • modulestring, optional

    The API name of the module for which the Webform A/B Testings were created. Use this to filter visitor counts by module. This parameter applies to both endpoints: when retrieving the visitor count for all Webform A/B Testings as well as for a specific test.

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/AB_testing/actions/visitors"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-X GET

Response JSON

The AB_testing JSON array is the root element that contains the visitor count for each Webform A/B Testing configuration. Each object consists of these inner keys:

  • visitors integer

    Represents the total number of visits recorded for the A/B Test. Each page load is counted as a visit, so multiple visits from the same visitor are counted individually.

  • started_time datetime

    Represents the date and time when the A/B Testing was started.

  • days integer

    Represents the number of days the A/B Testing has been running since it started.

  • id string

    Represents the unique ID of the Webform A/B Testing.

Sample Response when visitors count of all Webform A/B Testing are retrieved

Copied{
    "AB_testing": [
        {
            "visitors": 6,
            "started_time": "2026-01-11T18:41:34+05:30",
            "days": 1,
            "id": "4794410000000772083"
        },
        {
            "visitors": 8,
            "started_time": "2026-01-11T18:42:18+05:30",
            "days": 1,
            "id": "4794410000000772127"
        }
    ]
}

Possible Errors

  • INVALID_DATA HTTP 400

    The resource path index specified in the request URL is invalid, or the Webform A/B Testing ID provided does not exist.
    Resolution: Verify the URL path and ensure that a valid Webform A/B Testing ID is placed correctly in the endpoint.

  • INVALID_MODULE HTTP 400

    The module name provided in the request is invalid or unsupported.
    Resolution: Specify a valid module API name that supports Webform A/B Testing.

  • NO_PERMISSION HTTP 403

    You do not have sufficient permissions to access A/B Testing visitor details.
    Resolution: Ensure that your profile has the required permission for Webform A/B Testing.

Sample Response when visitors count of a specific Webform A/B Testing is retrieved

Copied{
    "AB_testing": [
        {
            "visitors": 8,
            "started_time": "2026-01-11T18:42:18+05:30",
            "days": 1,
            "id": "4794410000000772127"
        }
    ]
}