Change Helpdesk Email Pull Frequency

By default, Frappe Helpdesk checks for new emails every 10 minutes. If you need incoming emails to be fetched more frequently, you can configure a scheduled Server Script to pull emails at your preferred interval.

Create a Server Script

1. Go to Desk.
2. Search for Server Script.
3. Click New.

Configure the Server Script

Create the script using the following settings:

• Script Type: Scheduler Event
• Event Frequency: All or Cron

Your configuration should look similar to the example below.

Add the Script

Paste the following code into the script editor:

frappe.call(
    "frappe.email.doctype.email_account.email_account.pull_emails",
    email_account="Sales"
)

Configure the Schedule

Choose how frequently the script should run using one of the available scheduler options.

All

Selecting All runs the script approximately every 4 minutes.

Cron

To run the script at a custom interval, select Cron and enter a CRON expression using the following format:

*/n * * * *

Replace n with the number of minutes between each email sync.

Common Examples

How It Works

Each time the scheduled script runs, Helpdesk calls the email synchronization method for the specified Email Account and imports any new emails into the system. New emails are then processed normally, including ticket creation and email threading.

Best Practices

• Use shorter intervals only if your support team requires near real-time email processing.
• Avoid extremely frequent schedules unless your server can comfortably handle the additional load.
• Create one scheduler script per Email Account if you need different sync intervals.
• Verify the Email Account name before saving the script to avoid synchronization failures.