POST

Ticket.SearchCustomers

Search contactus by name or email for the ticket customer assigner on customer-tickets. Empty q returns items=[].

Permissions

  • User must be logged in with a valid bearer token.
  • Returned or changed records are limited by the user permissions, team access, folder access, and account settings.

Action

  • Runs the Ticket.SearchCustomers 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

  • q is optional. If omitted or blank, response is success with items=[].
  • Aliases for q: search, searchh.
  • Matches name LIKE or email LIKE; limited to 20 results.
  • phone prefers mobile when set, else phone.
  • Use returned id as cust_id in Ticket.AssignCustomer.

Required Parameters

No body parameters are required for this function.

Optional Parameters

NameTypeSampleWhat it gives
q
post
stringdanaSearch text. Aliases: search, searchh. Optional — empty returns items=[].

Authentication

Send the bearer token returned by Login in the request header.

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Ticket.SearchCustomers",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "q": "dana"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Ticket.SearchCustomers",
    "url_domain": "https:\/\/{domain}\/app\/Ticket.SearchCustomers"
}

Endpoint

POST /app/Ticket.SearchCustomers
POST https://{user}.bull36.com/app/Ticket.SearchCustomers
POST https://{domain}/app/Ticket.SearchCustomers

Sample Output

{
    "success": 1,
    "items": [
        {
            "id": 100,
            "name": "Dana Cohen",
            "email": "[email protected]",
            "phone": "0500000000"
        }
    ]
}

JavaScript Example

const token = 'YOUR TOKEN';
const body = new URLSearchParams({ q: 'dana' });
const res = await fetch('/app/Ticket.SearchCustomers', { method: 'POST', headers: { Authorization: 'Bearer ' + token }, body });
console.log(await res.json());

Error Example

{
    "success": 1,
    "items": []
}