EntriesSettings.Add

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

• Creates one entry/tab definition with labels, folders, sharing, status map, and custom fields in dashboard format.
• The created id is later used as entry_id on Entries.List/Add/Get/Update/Delete.

Push Service

Emits entriessettings.created. No row-level entry socket is sent.

Automation

No business automation is run for entry settings changes.

Special Instructions

• Required: tab_name_en and tab_name_he. Both are required on the dashboard create modal.
• status is NOT int 1/0. Send a JSON array of statuses; the API stores dashboard unique ids like Tab_setting::add_tabs_setting. Each status has label_en, color_name, and sub_status ("" or an array).
• fields is a JSON object keyed by dashboard unique ids (23 chars: timestamp+uniqid), same as Tab_setting::add_custom_fild_tabs. Friendly keys like fld_note are converted to unique ids on save.
• You may send a simple array of fields; the API expands each one to the dashboard shape (name, field_no, date, input_type, labels, and type-specific keys).
• folders must be a JSON array of folder ids, e.g. ["3"]. Do not send a bare id like 12. Alias: folder_name.
• shard_with is a JSON array of team member ids, e.g. ["47","51"]. This is sharing, not customer ids.
• Allowed input_type values: text, email, number, date, hour, date_time, select, yes_no, button, formula, team_member, title, customer, Files, year.
• If use_customer_for_entry is 1, entry_customer_folder_id is required.
• After creating settings, call User.Basic again so the UI has the new entry id.

Required Parameters

Optional Parameters

JSON Structure

{"17845458326a5e02280a638":{"label_en":"Open","color_name":"#ffa500","sub_status":[{"sub_status_label":"Waiting","sub_stauts_color":"#cccccc","sub_status_key":"17845458336a5e02280a639"}]}}

{"17845458326a5e02280a638":{"name":"17845458326a5e02280a638","field_no":1,"date":"2026-07-20 11:10:32","input_type":"text","label_en":"Note","label_he":"Note","default_value":""},"17845468846a5e0644d4010":{"name":"17845468846a5e0644d4010","field_no":2,"date":"2026-07-20 11:28:04","input_type":"select","label_en":"test_selct","label_he":"test_selct","is_multiple":0,"opt_name_he":{"17845468846a5e0644d4018":"test 1","17845468846a5e0644d401a":"test 2"},"opt_name_en":{"17845468846a5e0644d4018":"test 1","17845468846a5e0644d401a":"test 2"}}}

["3"]

Authentication

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

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/EntriesSettings.Add",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "tab_name_en": "Lead data",
        "tab_name_he": "Lead data",
        "folders": "[\"3\"]",
        "show_in_header": "1",
        "copy_customer_tab": "0",
        "use_customer_for_entry": "0",
        "status": "[{\"label_en\":\"Open\",\"color_name\":\"#ffa500\",\"sub_status\":[{\"sub_status_label\":\"Waiting\",\"sub_stauts_color\":\"#cccccc\"}]}]",
        "fields": "[{\"input_type\":\"text\",\"label_en\":\"Note\",\"label_he\":\"Note\"},{\"input_type\":\"select\",\"label_en\":\"test_selct\",\"label_he\":\"test_selct\",\"is_multiple\":0,\"opt_name_en\":[\"test 1\",\"test 2\"],\"opt_name_he\":[\"test 1\",\"test 2\"]}]"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/EntriesSettings.Add",
    "url_domain": "https:\/\/{domain}\/app\/EntriesSettings.Add"
}

Endpoint

POST /app/EntriesSettings.Add
POST https://{user}.bull36.com/app/EntriesSettings.Add
POST https://{domain}/app/EntriesSettings.Add

Sample Output

{
    "success": 1,
    "id": 745,
    "message": "Record added successfully.",
    "socket_event": "entriessettings.created"
}

JavaScript Example

const token = 'YOUR TOKEN';
const body = new URLSearchParams({
  tab_name_en: 'Lead data',
  tab_name_he: 'Lead data',
  folders: JSON.stringify(['3']),
  show_in_header: '1',
  status: JSON.stringify([
    {
      label_en: 'Open',
      color_name: '#ffa500',
      sub_status: [
        { sub_status_label: 'Waiting', sub_stauts_color: '#cccccc' }
      ]
    }
  ]),
  fields: JSON.stringify([
    { input_type: 'text', label_en: 'Note', label_he: 'Note' },
    {
      input_type: 'select',
      label_en: 'test_selct',
      label_he: 'test_selct',
      is_multiple: 0,
      opt_name_en: ['test 1', 'test 2'],
      opt_name_he: ['test 1', 'test 2']
    }
  ])
});
const res = await fetch('/app/EntriesSettings.Add', {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body
});
console.log(await res.json());

Error Example

{
    "success": 0,
    "message": "Missing required parameter: tab_name_en, tab_name_he"
}