POST

Customer.Reminder.Add

Create a customer reminder in contactus_reminder. Same logic as dashboard setting/highlight_time_and_color_update when reminder_id is empty. Distinct from Customer.FollowUp which updates contactus.followup.

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 Customer.Reminder.Add function and returns JSON.

Push Service

Pushes customer.reminder.created to connected clients.

Automation

Runs automation event on_create_reminder after insert when configured.

Special Instructions

Send the bearer token on protected calls with Authorization: Bearer YOUR TOKEN.
Send parameters as POST body fields exactly as documented.
Send date/time values in UTC Y-m-d H:i:s format when a date or datetime field is used.

Required Parameters

Name	Type	Sample	Explanation
`customer_id` post	int	`58`	Customer id. Alias: cust_id.
`date_time` post	datetime	`2026-07-28 10:00:00`	Reminder date/time in the logged-in user timezone. Aliases: date_time_heilight_js, date_time_for_this, date_and_time. Send UTC date/time as Y-m-d H:i:s, for example 2026-07-20 10:00:00. The SDK converts user local Date/local datetime input to UTC before posting.

Optional Parameters

Name	Type	Sample	What it gives
`notes` post	string	`Call back tomorrow`	Reminder note. Alias: notes_for_heilight_time_soket, note.
`reminder_by` post	string	`email`	Channel: email, popup, sms, whatsapp, sip. Alias: reminder_type. Default email.
`create_by` post	int	`1`	Team member who created the reminder. Defaults to logged-in user.
`send_to_wp` post	int	`0`	Send WhatsApp notification. Alias: send_to_whatsapp. Auto 1 when reminder_by=whatsapp.

Authentication

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

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Customer.Reminder.Add",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "customer_id": "58",
        "date_time": "2026-07-28 10:00:00",
        "notes": "Call back tomorrow",
        "reminder_by": "email"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Customer.Reminder.Add",
    "url_domain": "https:\/\/{domain}\/app\/Customer.Reminder.Add"
}

Endpoint

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

Sample Output

{
    "success": 1,
    "message": "Success",
    "reminder_id": 12,
    "automation_event": "on_create_reminder",
    "socket_event": "customer.reminder.created"
}

JavaScript Example

const token = 'YOUR TOKEN';
const body = new URLSearchParams();
body.set('customer_id', '58');
body.set('date_time', '2026-07-28 10:00:00');
body.set('notes', 'Call back tomorrow');
body.set('reminder_by', 'email');
const res = await fetch('/app/Customer.Reminder.Add', { method: 'POST', headers: { Authorization: 'Bearer ' + token }, body });
console.log(await res.json());

Error Example

{
    "success": 0,
    "message": "Permission denied"
}