POST

CustomerStatuses.Update

Alias of CustomerStatuses.Edit.

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

Updates the requested CustomerStatuses record after validating permissions and input fields.

Push Service

Pushes event customerstatuses.edit.updated to users who should see this change.

Automation

No automation is run for this function.

Special Instructions

Custom status (has delete icon): send old_name, name, status_color. Same as dashboard custom_customer_status_form.
Default status (no delete icon): send cust_dynamic_name_id, name_for, cust_name_en, cust_name_he, status_color. Same as dashboard settings_cust_table_status_form.
name_for keys for defaults: new, active, in work, No Answer, Answer.

Required Parameters

No body parameters are required for this function.

Optional Parameters

Name	Type	Sample	What it gives
`old_name` post	string	`ddddd123`	Custom edit: current status name. Required for custom statuses.
`name` post	string	`ddddd123`	Custom edit: new status name. Required with old_name.
`cust_dynamic_name_id` post	int	`1118`	Default edit: cust_dynamic_name id. Send 0 when the default status has not been saved yet.
`name_for` post	string	`No Answer`	Default edit: system key (new, active, in work, No Answer, Answer).
`cust_name_en` post	string	`No Answer 1`	Default edit: English label.
`cust_name_he` post	string	`אין תשובה`	Default edit: Hebrew label.
`status_color` post	string	`#e33737`	Color for both custom and default edit.

Authentication

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

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/CustomerStatuses.Update",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "cust_dynamic_name_id": "1118",
        "name_for": "No Answer",
        "cust_name_en": "No Answer 1",
        "cust_name_he": "אין תשובה",
        "status_color": "#e33737"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/CustomerStatuses.Update",
    "url_domain": "https:\/\/{domain}\/app\/CustomerStatuses.Update"
}

Endpoint

POST /app/CustomerStatuses.Update
POST https://{user}.bull36.com/app/CustomerStatuses.Update
POST https://{domain}/app/CustomerStatuses.Update

Sample Output

{
    "success": 1,
    "message": "Success",
    "id": "1118",
    "name_for": "No Answer",
    "socket_event": "customerstatuses.edit.updated"
}

JavaScript Example

const token = 'YOUR TOKEN';
// Default status (settings_cust_table_status_form)
const defaultBody = new URLSearchParams({
  cust_dynamic_name_id: '1118',
  name_for: 'No Answer',
  cust_name_en: 'No Answer 1',
  cust_name_he: 'אין תשובה',
  status_color: '#e33737'
});
await fetch('/app/CustomerStatuses.Update', { method: 'POST', headers: { Authorization: 'Bearer ' + token }, body: defaultBody });

// Custom status (custom_customer_status_form)
const customBody = new URLSearchParams({ old_name: 'ddddd123', name: 'ddddd123', status_color: '#000000' });
await fetch('/app/CustomerStatuses.Update', { method: 'POST', headers: { Authorization: 'Bearer ' + token }, body: customBody });

Error Example

{
    "success": 0,
    "message": "Missing required parameter: old_name or name_for"
}