POST

Customer.Today

Return the count and list of customers created today (date_created). Uses the same permissions, archive rules, and optional filters as Customer.List. Page size is capped at 25.

Permissions

  • On a company subdomain (e.g. https://{user_domain}.bull36.com) the user must match that Host — Login and protected APIs reject another company with success=0, error user_not_in_company. On a main brand host (bull36.com, biz1.co.il, mastrocrm.com, …) the company domain gate is skipped.
  • User sees only customers allowed by account permissions, team access, folder access, and sharing rules.

Action

  • Runs the Customer.Today function and returns JSON.

Push Service

No push is sent because this function only reads data or returns helper information.

Automation

No automation is run for this function.

Special Instructions

  • On a company subdomain (e.g. https://{user_domain}.bull36.com) the user must match that Host — Login and protected APIs reject another company with success=0, error user_not_in_company. On a main brand host (bull36.com, biz1.co.il, mastrocrm.com, …) the company domain gate is skipped.
  • Date window is always today on the API server calendar; do not send created_from/created_to.
  • Optional filters such as folder_id, tag, source still work the same as Customer.List.
  • For another day range use Customer.List / Customer.Count with created_from and created_to.

Required Parameters

No body parameters are required for this function.

Optional Parameters

NameTypeSampleWhat it gives
start
post
int0First row offset for paging.
length
post
int25Maximum rows to return. Values above 25 are capped to 25.
folder_id
post
int1Optional folder filter (same as Customer.List).
include_trash_customer
post
int0Includes archived customers when set to 1. Default keeps archive = 0.
filter_data
post
stringjohnOptional search text (same as Customer.List).

Authentication

Send the bearer token returned by Login in the request header. The user must be from the same company domain as this Host — a token from another company is rejected (user_not_in_company).

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Customer.Today",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "start": "0",
        "length": "25"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Customer.Today",
    "url_domain": "https:\/\/{domain}\/app\/Customer.Today"
}

Endpoint

POST /app/Customer.Today
POST https://{user}.bull36.com/app/Customer.Today
POST https://{domain}/app/Customer.Today

Sample Output

{
    "success": 1,
    "date": "2026-10-23",
    "count": 12,
    "recordsTotal": 12,
    "recordsFiltered": 12,
    "start": 0,
    "limit": 25,
    "data": [
        {
            "id": "123",
            "customer_id": "123",
            "name": "John Demo",
            "mobile": "0500000000",
            "date_created": "2026-10-23 09:15:00"
        }
    ]
}

JavaScript Example

const token = 'YOUR TOKEN';
const res = await fetch('/app/Customer.Today', {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ start: '0', length: '25' })
});
const data = await res.json();
console.log(data.count, data.data);

Error Example

{
    "success": "0",
    "error": "bearer_token_required",
    "message": "Authorization bearer token is required. Send header: Authorization: Bearer YOUR TOKEN"
}