Wiresk

Wiresk

Gmail – Triggers

Estimated reading time: 11 min

What will start your automation…

Run Once Tab: This tab allows you to schedule a Flow to execute a single time at a specific date and time. This is ideal for one-time operations such as data syncs, cleanups, or initial configuration steps. After execution, the schedule will be automatically cleared unless rescheduled manually.

Run Tab: This tab is used to set up repeating schedules:

  • Repeat feature: This dropdown determines how long the automation will continue repeating based on the selected frequency (Minutely or Hourly). You can choose from:
    • Repeat Forever
      • The automation will continue to run indefinitely at the defined interval (e.g. every 15 minutes).
      • No end condition is specified.
    • Repeat for (x) Times
      • You set a specific number of repetitions.
      • Requires the field Number (x) of Repeat Times to be filled (e.g. 10 times).
    • Repeat Between Start & End Dates
      • The automation will run only within a defined date range.
      • Additional fields will appear to select start and end dates.
      • Useful for limited-time schedules like campaigns or batch jobs.
  • Daily at Multiple Times: Sets the Flow to run several times per day based on a minutely or hourly interval.
  • Daily: This allows a Flow to run x times per day at a specific time.
  • Weekly: This allows you to run a Flow weekly by selecting the days and time.
  • Monthly: This will monitor your Trigger every month on a defined date and hour.
  • Yearly: This will monitor your Trigger on a specific date and hour every year.
  • Specific dates: This will start your Trigger on specific dates and time.

For more details, see Wiresk Scheduler – The Fundamentals.

After you’ve configured your Trigger parameters, select the “Use” button to fetch a live sample of data from the Trigger.

What it does:

  • Extracts real data based on your Trigger setup
  • Validates your parameters by showing if they match existing records
  • Prepares data for field mapping – the sample helps you map your Trigger output to your Method parameters in the Flow. Refer to FIELD MAPPING documentation.

Think of it as a preview step: it makes sure your Trigger is working and gives you real data to work with when setting up the rest of your flow.

The table below list the data set sample from the Triggers. You can use this table to map your input field.

Field Mapping Table

FIELDDESCRIPTION
IDUnique identifier for this email.
Internal DateThe internal timestamp of the email.
LabelsLabels associated with the email indicating its status and category.
Size EstimateEstimated size of the email in bytes.
SnippetA brief snippet or summary of the email content.
Thread IDIdentifier for the email thread this message belongs to.
Delivered-ToThe recipient’s email address.
ReceivedInformation about the mail server that received the email.
X-ReceivedAdditional SMTP receipt information.
MIME-VersionMIME version used.
ReferencesIndicates the message is part of a reply thread.
In-Reply-ToIndicates the message is part of a reply thread.
FromSender’s name and email address.
DateDate and time the email was sent.
Message-IDUnique identifier for the email message.
SubjectSubject of the email.
ToRecipient’s name and email address.
Content-TypeIndicates the email content is in multiple formats (e.g., plain text and HTML).
Text BodyPlain text version of the email content.
HTML BodyHTML version of the email content.
Attachment FilenameName of the attached file.
Attachment MIME TypeMIME type of attachment.
Attachment IDUnique identifier for the attachment.
icon gmail 1 Gmail - Triggers

These Triggers will start your Flow automatically at a specific time or intervals instead of being triggered by events like Webhooks.

Configuration Table:

(*) required field

Name*New Email Thread
Connection*Select your Google connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage. 
Recurrence rule/scheduler*Set up your recurrence rule.

⚠️ Reminder: Click “Use” to validate your Trigger with sample data before saving.

Configuration Table:

(*) required field

Name*New Label Created
Connection*Select your Google connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage. 
Recurrence rule/scheduler*Set up your recurrence rule.

⚠️ Reminder: Click “Use” to validate your Trigger with sample data before saving.

Configuration Table:

(*) required field

Name *Received Mail with Attachment
Connection*Select your Google connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage. 
Recurrence rule/scheduler*Set up your recurrence rule.

PARAMETERS

This tab enables you to configure the Trigger.

Mailbox*:

Select the mailbox where your emails are located.

This tab allows you to preview the data that will be retrieved and included in the output.

In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available” will be displayed.

preview data button 2025 04 09 Gmail - Triggers

Use this button to preview the data based on the “Configure Parameter” tab.

⚠️ Reminder: Click “Use” to validate your Trigger with sample data before saving.

Configuration Table:

(*) required field

Name *New Starred Email
Connection*Select your Google connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage. 
Recurrence rule/scheduler*Set up your recurrence rule.

⚠️ Reminder: Click “Use” to validate your Trigger with sample data before saving.

Configuration Table:

(*) required field

Name*New Labeled Email
Connection*Select your Google connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage. 
Recurrence rule/scheduler*Set up your recurrence rule.

PARAMETERS

This tab enables you to configure the Trigger.

Mailbox*:

Select the mailbox or label where want to monitor the incoming emails.

This tab allows you to preview the data that will be retrieved and included in the output.

In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available” will be displayed.

preview data button 2025 04 09 Gmail - Triggers

Use this button to preview the data based on the “Configure Parameter” tab.

⚠️ Reminder: Click “Use” to validate your Trigger with sample data before saving.

Configuration Table:

(*) required field

Name*Find Multiple Gmails by Search Query
Connection*Select your Google connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage. 
Recurrence rule/scheduler*Set up your recurrence rule.

PARAMETERS

This tab enables you to configure the Trigger.

Search String*:

Enter your search query criteria to filter your emails.

Limit record per page:

Set the limit of record per page.

Record to be skip:

Skip unwanted record.

This tab allows you to preview the data that will be retrieved and included in the output.

In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available” will be displayed.

preview data button 2025 04 09 Gmail - Triggers

Use this button to preview the data based on the “Configure Parameter” tab.

⚠️ Reminder: Click “Use” to validate your Trigger with sample data before saving.

Configuration Table:

(*) required field

Name*Track email conversation
Connection*Select your Google connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage. 
Recurrence rule/scheduler*Set up your recurrence rule.

PARAMETERS

This tab enables you to configure the Trigger.

Thread*:

Select the thread that you want to monitor.

This tab allows you to preview the data that will be retrieved and included in the output.

In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available” will be displayed.

preview data button 2025 04 09 Gmail - Triggers

Use this button to preview the data based on the “Configure Parameter” tab.

⚠️ Reminder: Click “Use” to validate your Trigger with sample data before saving.

Configuration Table:

(*) required field

Name*Received mail with Specific Search
Connection*Select your Google connection or create one.
Time outYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage. 
Recurrence rule/scheduler*Set up your recurrence rule.

PARAMETERS

This tab enables you to configure the Trigger.

Mailbox*:

Choose the mailbox where you receive your new emails.

Search String*:

Enter your search query criteria to filter your emails.

Search from subject or body.

This tab allows you to preview the data that will be retrieved and included in the output.

In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available” will be displayed.

preview data button 2025 04 09 Gmail - Triggers

Use this button to preview the data based on the “Configure Parameter” tab.

⚠️ Reminder: Click “Use” to validate your Trigger with sample data before saving.

Configuration Table:

Name*New Email Received
Connection*Select your connection or create one.
TimeoutYou can additionally set the Trigger duration to limit the information processed per execution to optimize performance and resource usage.
Recurrence Rule/scheduler*Set up your recurrence rule.

PARAMETERS

This tab enables you to configure the Trigger.

Mailbox*:

Select the mailbox where you receive your new emails.

This tab allows you to preview the data that will be retrieved and included in the output.

In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, a message “No data available” will be displayed.

preview data button 2025 04 09 Gmail - Triggers

Use this button to preview the data based on the “Configure Parameter” tab.

(*) required field

⚠️ Reminder: Click “Use” to validate your Trigger with sample data before saving.

Once your Flow is configured, you can test or automate it using the Run panel or by managing Triggers from the Flow Management screen.

  • Run Flow: Manually runs the Flow once using sample data. Ideal for testing logic and field mapping. See How to Run a Flow.
  • Run Scheduler: Force-runs the Trigger immediately using live input. This bypasses the recurrence rule and is useful for verifying real data mapping. Learn more in Wiresk Scheduler – The Fundamentals.

From the Trigger management panel (clock icon), you can:

  • Activate or deactivate Triggers
  • Force-run the scheduler
  • Copy Routing Keys (for HTTP Triggers)

If your Flow uses a Webhook Trigger, it runs automatically on each incoming webhook—no scheduler required. It remains active until you manually deactivate it.