Gmail is a product of Google; it is one of the most popular Email services and it is seamlessly connected to other Google services.
With your Gmail account integrated to our Wiresk platform, you can manage it effortlessly and efficiently. Keep an eye on your threads, mark important emails or follow current conversation with ease. By going through this Gmail documentation, step by step, you will find more possibilities that suit your needs.
You can find the Gmail API Documentation for more Endpoints (Methods).
1 – Wiresk Group system Copy Link
The group system in Wiresk is a way to organize and manage your users and Flows, in fact you can manage multiple groups and users in one place!
When you start with Wiresk(Admin account), you are automatically assigned to the default group. This default group can be renamed.
for users with Pro plan or higher, you can:
- Assign users to specific Flows: Control who has access to and can edit different Flows.
- Organize Flows: Group related Flows together for better management and visibility.
- Manage permissions: Set permissions for different groups, determining who can create, edit, and view Flows.
- Collaborate effectively: Facilitate collaboration among team members by assigning them to appropriate groups.
2 – Connect Google to Wiresk Copy Link
A connection to your Google account is needed so we can sync it with our platform.
There are two ways to connect your app to Wiresk:
- In “My apps” section, where you can manage your connections (select or create your group first to get access to this section, refer to the Group system ).
- While building your Flow, you can easily establish a connection to your app directly within the Flow builder. This can be done during the setup of either a Trigger or a Method.
In this documentation, we will explain how to create a connection in “My apps” section, it is essentially the same as when creating it on-the-go.
Create your Google application in Wiresk Copy Link
On the left panel of Wiresk user interface, go to “My apps” then search “Google” in the search field or scroll down the list of apps and choose the Google icon.
In the new screen, give a name to your connection, for example “Google or Gmail”. Then you have the option to either:
- Link it with a single Google app (in this case Gmail) for specific functionality.
- Grant access to all Google apps for this connection, allowing broader use of your account.
Link your Google account to Wiresk Copy Link
Now connect your Google account by clicking on the button “Continue with Google”, you will be redirected to Google connection page.
If you have previously connected to your Google account, choose your account name or sign in with your Google account.
then on the screen “Sign in to Wiresk.com “click on continue.
Give access to Wiresk.com by clicking on “select all” then click continue.
you will be redirected to the connection creation screen then just click save and voila! You have connected your Google account to Wiresk.
3 – Create your Automated Flows with Gmail Copy Link
After connecting your Google account to Wiresk, you can start creating your Flow with Gmail.
A – Create a Flow Copy Link
Select your Group, then on the Flow management screen click on “Create Flow”.
Select the Trigger Copy Link
- On the new screen, name the Flow that you want to create.
- Add your Trigger by clicking on the red plus (+) button. On the Triggers selection screen, search your app or select it from the list below the screen.
- Now, select your specific Trigger then configure it (refer to Trigger settings below).
As mentioned in “How to connect your app to Wiresk” above, during your Trigger settings, you can create a new connection to your apps at this stage.
B – Add an HTTP Trigger to your Flow Copy Link
An HTTP Trigger allows you to manually activate your Flows.
Common Use Cases for Manual Triggers: Copy Link
- One-time tasks: For tasks that only need to be performed once, like sending a specific notification or updating a database record.
- Ad-hoc actions: For actions that need to be triggered on demand, without relying on scheduled events or data changes.
- Testing and debugging: For testing and debugging Flows without relying on external events or conditions.
HTTP Trigger settings Copy Link
Click on the red plus button (+) again to add a Trigger for testing your Flow, then click on the button “HTTP Trigger”.
Write a description and select your API key or create a new one.
Click on save.
Now you can use your HTTP Trigger to Manually run your Flow.
C – Add a Method to your Flow Copy Link
The Method will perform a specific task on a particular app or service you’ve connected to Wiresk like get info or send emails.
You can add at least 1 or multiple Methods for complex Flows (a maximum of 255 Methods).
On the Flow builder screen, click on the plus button (+) next to the Trigger icon.
Search or scroll down to select your apps Methods. Refer to Methods list and setting in this documentation.
D – Add Wiresk Tools to your Flow Copy Link
If you want to build a complex Flow, Wiresk offers a selection of tools at your disposal. Refer to Wiresk’s Tools
To add Tools in your Flow, Follow the same step as adding the Methods. On the Flow builder screen, click on the plus button (+) then just click on the “Tool” tab and select the Tool that you want to add.
4 – Gmail Trigger settings Copy Link
What will start your automation…
Recurrence rule or scheduler settings Copy Link
You can control when and how often your Flow is triggered and executed.
Select and configure the recurrence rule or scheduler of your Trigger (if the Trigger is not a Webhook):
- Regular intervals will monitor your Trigger by intervals in minute
- Daily recurrence will monitor your Trigger by day and hour
- Monthly recurrence will monitor your Trigger every month on a defined date and hour
- Yearly recurrence will monitor your Trigger on a specific date and hour every year
- Specific dates will start your Trigger on specific dates
Get sample Copy Link
After setting up the Trigger parameters (read how to define your parameters in the following steps below), click on “Get sample”.
The “Get sample” allows you to extract a subset of data for validation. The data will be used to MAP your Method parameters according to your Flow. Refer to FIELD MAPPING documentation.
Gmail Triggers list and settings Copy Link
Trigger Field Mapping Table: Copy Link
The table below list the data set sample from the Triggers. You can use this table to map your input field.
Field Mapping Table
| FIELD | DESCRIPTION |
|---|---|
| ID | Unique identifier for this email. |
| Internal Date | The internal timestamp of the email |
| Labels | Labels associated with the email indicating its status and category. |
| Size Estimate | Estimated size of the email in bytes. |
| Snippet | A brief snippet or summary of the email content. |
| Thread ID | Identifier for the email thread this message belongs to. |
| Delivered-To | The recipient’s email address. |
| Received | Information about the mail server that received the email. |
| X-Received | Additional SMTP receipt information. |
| MIME-Version | MIME version used. |
| References | Indicates the message is part of a reply thread. |
| In-Reply-To | Indicates the message is part of a reply thread. |
| From | Sender’s name and email address. |
| Date | Date and time the email was sent. |
| Message-ID | Unique identifier for the email message. |
| Subject | Subject of the email. |
| To | Recipient’s name and email address. |
| Content-Type | Indicates the email content is in multiple formats (e.g., plain text and HTML). |
| Text Body | Plain text version of the email content. |
| HTML Body | HTML version of the email content. |
| Attachment Filename | Name of the attached file. |
| Attachment MIME Type | MIME type of attachment. |
| Attachment ID | Unique identifier for the attachment. |
Received Email Copy Link
Triggered when a new Email has been received
– General notification system
– Automatic email sorting and labelling
– Logging and archiving emails
– Auto-responde
– Task creation
– Customer support triage
| Name* | Received Email |
| Connection* | Select your Google connection or create one |
| Time out | You 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 | |
| Mailbox* | Select the mailbox where you receive your new emails |
| Preview Data | Preview the retrieved data. In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, an error message will be displayed. |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
New Starred Email Copy Link
Triggered when you add a star to an email
For example, as a project manager, you can Trigger a notification to the relevant team member when a project related email is starred.
This Trigger can be useful for prioritizing and managing important emails more efficiently.
For example, as a project manager, you can Trigger a notification to the relevant team member when a project related email is starred.
| Name * | New Starred Email |
| Connection* | Select your Google connection or create one |
| Time out | You 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 |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
Find Multiple Emails by Search Query Copy Link
Triggered when multiple emails are found by search query
| Name* | Find Multiple Emails by Search Query |
| Connection* | Select your Google connection or create one |
| Time out | You 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 | |
| Search string* | Enter your search query criteria to filter your emails.Use Gmail search format like subject: bill, label: inbox |
| Limit record per page | Set the limit of record per page |
| Record to be skip | Skip unwanted record |
| Preview Data | Preview the retrieved data. In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, an error message will be displayed. |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
New Label Copy Link
Triggered when new label is created
“New Label” Trigger could be used for example, for project Management.
Possibility of user story: A project manager wants to ensure that emails related to different projects are organized and shared with the respective team members automatically so that everyone stays informed and updated on project-related communications.
Let’s see how to apply this user story in Wiresk:
– Create a label, for example, “Project Wiresk” in Gmail.
– Select the Trigger “new label” in Wiresk. It will initiate your Flow when you create a new label in your Gmail account.
– Extract the label and categorize the email then forward the email to the respective project team members based on the label.
– Save the email to a shared project folder or project management tool
– Then send a notification to the “Project Wiresk” team in Microsoft Teams with details about the new email.
| Name* | New Label |
| Connection* | Select your Google connection or create one |
| Time out | You 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 |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
New Thread Copy Link
This Trigger can be applied to customer support platforms, project management tools or teams’ collaboration apps.
For a better understanding, let’s imagine this user story:
As a customer support manager, I want to automatically assign a new support thread to the appropriate team member.
Now, let’s see how this user story could be adapted in Wiresk:
– Trigger: Select “New thread” and configure it to activate when you receive a new email thread in your Support inbox Gmail account.
– Analyze: Wiresk analyzes the email content (for example, keywords, subject line) to identify the support topic (billing, technical issue etc…).
– Assign to a team member: Wiresk automatically assigns the thread to the relevant team member in a CRM solution.
– Notification: Wiresk can notify the assigned team member about the new thread.
(*) required field
| Name* | New thread |
| Connection* | Select your Google connection or create one |
| Time out | You 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 |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
Received Mail with Specific Search Copy Link
Triggered when a new email has been received that match your criteria
This Trigger doesn’t react to just any new email, it only works when the new email meets the search conditions.
Starting your Flow with this Trigger is useful for automating responses and actions based on important emails.
More example of use case:
– Automatically process customer support tickets
– Capture new lead from email
– Follow-up on sales inquiries
– Track project update
– Automate document approval processes
– Send alert for critical emails
| Name* | Received mail with Specific Search |
| Connection* | Select your Google connection or create one |
| Time out | You 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 | |
| Mailbox* | Choose the mailbox where you receive your new emails |
| Search string* | Enter your search criteria to identify the new emails |
| Preview Data | Preview the retrieved data. In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, an error message will be displayed. |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
Find an Email by Search Query Copy Link
Triggered when one email is found with search query
| Name* | Find an email by search query |
| Connection* | Select your Google connection or create one |
| Time out | You 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 | |
| Mailbox* | Select the mailbox where your emails are located |
| Search query criteria* | Enter your search query criteria to filter your emails.Use Gmail search format like subject: bill, label: inbox |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
Add Label to an Email Copy Link
Triggered when a label has been added to an email
– Automatically create a task in a project management tool
– Track and manage customer support workflow
– Set reminders for important emails
– Automate invoice management
– Organize email for better productivity
– Get notified of critical emails
| Name* | Add Label to an Email |
| Connection* | Select your Google connection or create one |
| Time out | You 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 | |
| Mailbox* | Select the mailbox where your Emails are located |
| Preview Data | Preview the retrieved data. In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, an error message will be displayed. |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
Received Email with Attachment Copy Link
Triggered when new email with attachment has been received
Example of user Story: As a Project Manager, I want to ensure that emails related to different projects are automatically organized and shared with the respective team members when they contain attachments so that the team members can promptly access relevant documents and information.
Let’s set up this Flow:
1 – Select “Received Email with Attachment “Trigger: The Flow will initiate when an email with an attachment is received in the Gmail inbox.
2 – Analyze the email content to determine the related project by using text analysis or predefined rules to identify the project based on keywords in the email subject, body or based on specific sender domains.
3 – Organize the email by moving to a specific project folder in Gmail or adding a label for better organization and future reference.
4 – Share the email and its attachment with the respective team members by automatically forwarding the email with the attachment to the email addresses of the team members assigned to the identified project.
5 – Notify the team about the new document by sending an internal notification (e.g., via Microsoft Teams or an internal messaging system) to inform the team members about the new document and its details. 5 – Optionally, you can update your project management tool (e.g., Jira) with a new task or Notes that includes the details of the received document.
| Name * | Received Email with Attachment |
| Connection* | Select your Google connection or create one |
| Time out | You 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 | |
| Mailbox* | Select the Mailbox that will receive the Email with attachment |
| Preview Data | Preview the retrieved data. In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, an error message will be displayed. |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
Track Email Conversation Copy Link
Triggered when there is a conversation in a selected email
This Trigger can be used to:
– Automatically manage support tickets and follow-up
– Make to response quickly to potential customers
– Keep project members informed
– Maintain records of important conversation
| Name* | Track email conversation |
| Connection* | Select your Google connection or create one |
| Time out | You 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 | |
| Thread* | Select the email that you want to monitor |
| Preview Data | Preview the retrieved data. In specific Trigger instances, data can only be previewed when it is available for retrieval. If no event occurs from the Trigger, an error message will be displayed. |
(*) required field
Before saving your Trigger, don’t forget to use “Get Sample”.
5 – Gmail Methods list and settings Copy Link
What your automation will do…
Send an Email Copy Link
The Method sends a new email to a recipient’s email address.
It can be customized with specific recipients, subject, email content, attachment or event invitation.
This Method can be used to:
– Notify your team members of important event or updates
– Schedule and send regular reports or reminder
– Communicate with your customers based on their actions
– Engage and encourage potential leads
– Manage and delegate tasks
| Name * | Send an email |
| Connection* | Select your Google connection or create one, the email will be sent from this account |
| Map fields | |
| To* | Enter the recipient email address |
| Cc | Enter the Cc recipient email address |
| Bcc | Enter the Bcc recipient email address |
| Subject* | Enter the email subject |
| Body | Enter the email content |
| Attachment file +Element (Optional) | |
| File name* | Enter the file name to be uploaded |
| File extension* | Enter the file extension |
| File content* | Enter the file content. For instruction on working with files, please refer to our Help Center |
| Event invitation (you can optionally include an invitation to an event.) | |
| Summary | Summary or title of the event |
| Even description | You can add details about the event such as location, agenda or purpose of the event. |
| Organizer email address | The organizer email address |
| Organizer display name | The organizer name |
| Sender email name | Name of the sender email |
| Start date and time | Starting date and time of the event |
| End date and time | Ending date and time of the event |
(*) required field
Reply an Email Copy Link
The Method replies to a selected email.
Here’s some short example of use Cases:
– Let customers know you received their email, and they can expect a response soon.
– Respond to appointment requests: Automatically confirm appointments with details like date, time, and location.
– Basically, automate any email response that follows the same format!
| Name* | Reply an email |
| Connection* | Select your Google connection or create one |
| Map fields | |
| Reply to* | Select the email that you want to reply to |
| Thread ID* | Select the email thread ID |
| To* | The recipient email address |
| Cc | The Cc recipient email address |
| Bcc | The Bcc recipient email address |
| Subject* | The email subject |
| Body | The message in your email that you want to send. |
| Attachment file +Element | |
| File name* | Enter the file name to be uploaded |
| File extension* | Enter the file extension |
| File content* | Enter the file content. |
(*) required field
Find an Email Copy Link
The Method finds an email with a search query, only one email will return.
You provide keywords or phrases like you would in a regular Gmail search.
Wiresk scans your Gmail account for emails that contain those keywords. The Flow can then perform actions based on the emails it finds.
Use Case Example:
Automating Invoice Processing: You set up the “Find an Email with Search Query” method to look for emails with “invoice” in the subject line and “your company name” in the recipient field.
Once Wiresk finds these emails, it can Trigger the following actions:
– Download the attached PDF invoice (if there is one).
– Extract key information like invoice number, amount due, and due date.
– Create a new entry in your accounting software with the extracted details.
Important Notes: The Method needs a clear and specific search query to find exactly the email you want. Define your search terms carefully, including keywords and phrases unique to the emails you’ll be automating. If the search fails, the Flow might not function as expected. You might need to refine your search criteria or add extra steps to your Flow to handle these situations.
| Name* | Find an email |
| Connection* | Select your Google connection or create one |
| Matching criteria | |
| Search string* | Enter your search criteria to find the email that match |
(*) required field
Find or Send an Email Copy Link
This Method will search for a specific email, if the email is not found, a new email will be sent to a recipient.
Now, let’s see How It Works: Wiresk will search in your Gmail account for an email based on your criteria.
If the email is found, you can take actions based on its contents and continue further steps. If Wiresk does not find the email matching your criteria, it will automatically send a new email that you have predefined the content.
| Name* | Find or send an email |
| Connection* | Select your Google connection or create one, the email will be sent from this account |
| Matching criteria | |
| Search string* | Enter your search criteria to find the email that match |
| Map fields | |
| To* | Enter the recipient email address |
| Cc | Enter the Cc recipient email address |
| Bcc | Enter the Bcc recipient email address |
| Subject* | Enter the email subject |
| Body | Enter the email content |
| Attachment file | |
| file name* | Enter the file name to be uploaded |
| file extension* | Enter the file extension |
| file content* | Enter the file content. For instruction on working with files, please refer to our Help Center |
(*) required field
Create Draft Email Copy Link
This Method creates a draft email in my Gmail account based on Triggers and predefined parameters.
this Method can be useful for:
– Appointment Scheduling: Generate draft emails that include scheduling links.
– Order Confirmations: Automatically draft emails confirming orders.
important Notes: If you want to include an attachment file within your drafted email, please refer to Base64 encoding for sending files within Wiresk.
| Name* | Create a new draft |
| Connection* | Select your Google connection or create one, the email will be draft in this account |
| Map fields | |
| To* | Enter the recipient email address |
| Cc | Enter the Cc recipient email address |
| Bcc | Enter the Bcc recipient email address |
| Subject* | Enter the email subject |
| Body | Enter the email content |
| Attachment file | |
| File name* | Enter the file name to be uploaded |
| File extension* | Enter the file extension |
| File content* | Enter the file content. |
(*) required field
Draft a Reply Copy Link
This Method will draft a reply from your Trigger or a specific email.
| Name * | Draft a reply |
| Connection* | Select your Google connection or create one, the email will be draft in this account |
| Map fields | |
| Reply to* | Select the email that you want to reply to |
| Thread ID* | Select the email thread ID |
| To* | Enter the recipient email address |
| Cc | Enter the Cc recipient email address |
| Bcc | Enter the Bcc recipient email address |
| Subject* | Enter the email subject |
| Body | Enter the email content |
| Attachment file | |
| File name* | Enter the file name to be uploaded |
| File extension* | Enter the file extension. |
| File content* | Enter the file content. |
(*) required field
Find or Draft Copy Link
This method searches an email and create a draft if no relevant email is found.
Find: this part search for an existing email in your Gmail account that match your search criteria.
Draft: if it doesn’t find the emails, this Method will create a draft email with your predefined contents like subject, body, recipient, attachments, etc.
This Method can be useful in:
– Automated email response
– Email tracking and management
– Creating and sending reports
– Template-based emails
| Name* | Find or draft an email |
| Connection* | Select your Google connection or create one, the email will draft in this account |
| Matching criteria | |
| Search string* | Enter your search criteria to find the email that match |
| Map fields | |
| To* | Enter the recipient email address |
| Cc | Enter the Cc recipient email address |
| Bcc | Enter the Bcc recipient email address |
| Subject* | Enter the email subject |
| Body | Enter the email content |
| Attachment file | |
| file name* | Enter the file name to be uploaded |
| file extension* | Enter the file extension. |
| file content* | Enter the file content. |
(*) required field
Create Label Copy Link
This method will Create a new label in your Gmail account.
How It Is Useful:
– Automatically categorize incoming emails
– Manage task-related emails
– Highlight important emails
– Sort emails
– Monitor specific emails for auditing purposes
– Screenshot parameters here
| Name* | Create label |
| Connection* | Select your Google connection or create one, the new label will be created in this account |
| Map fields | |
| Name* | Name the new label |
(*) required field
List Labels Copy Link
This Method retrieves a list of all labels in my Gmail account.
– Automate the organization of your new emails
– Handle your emails differently based on their labels
– Set up or adjust filter to manage your emails
– Generate reports on your email categorization
– Ensure labels are used consistently across your different workflows
You can add another Method for example, sending an email with the list of labels retrieved or get notified by telegram. Follow here to connect Telegram with Wiresk.
| Name* | List Labels |
| Connection* | Select your Google connection or create one |
(*) required field
Add Labels Copy Link
This Method will add an existing label to a specific email.
This Method can be used to:
– Automatically add a label “Important” to any email from your boss
– Label emails from specific clients
– Label emails related to a project
| Name* | Add labels |
| Connection* | Select your Google connection or create one |
| Matching criteria | |
| Email ID* | Select or enter the email ID to which you want to add the label |
| Map fields | |
| Name* | Choose the label |
(*) required field
Remove Label Copy Link
This Method will automatically remove specific labels from emails in your Gmail account.
Useful cases:
In a multi-step workflow, removing a label can signify the transition of an email from one stage to another.
Combine with other automation Method to create conditional workflows .
| Name* | Add labels |
| Connection* | Select your Google connection or create one |
| Matching criteria | |
| Email ID* | Select or enter the email ID to which you want to add the label |
| Map fields | |
| Name* | Choose the label |
(*) required field
6 – Test run or automate your Flow Copy Link
After setting up your Flow, you can choose to:
- “Run once”, your Flow will run only a single time. You can use this function to test your Flow. Refer to how to set up an HTTP Trigger, in the Trigger setting step.
- “Run Scheduler” will automate your Flows with the recurrence rule you previously defined.
For more details, refer to How to run a Flow tutorial in our Help Center.
If you are using a Webhook Trigger, the Flow will initiate automatically when a webhook is received from your connected apps. This means that the Flow is automated without a scheduler and will run until you deactivate the Flow manually. Refer to Webhook documentation in our Help Center.
If you need an integration that you cannot find in Wiresk, you can make a request to our team, and we will try our best to satisfy your needs.